API e integrações
Liga o Selfcare ao resto da tua empresa
Uma API REST documentada, webhooks assinados e um servidor MCP para assistentes de IA. Tudo age como a pessoa que liga a integração e vê só o que ela vê na app.
Incluída em todos os planos, sem custo extra.
Age como a pessoa
Cada pedido vale o que vale o papel de quem criou a chave ou autorizou a app. Ninguém vê pela API o que não vê na app.
Segura por omissão
Salários, atestados e documentos de saúde ou disciplinares nunca saem. O IBAN sai sempre mascarado e cada escrita fica no registo de auditoria.
Feita para programadores
OpenAPI 3.1 em português e inglês, erros com códigos estáveis, paginação por cursor, Idempotency-Key, empresa de teste e um SDK em TypeScript.
MCP: o Selfcare dentro do teu assistente de IANovo
Liga o Claude, o ChatGPT ou o Cursor ao Selfcare em dois minutos. Cada pessoa entra com a sua conta e o assistente passa a poder marcar férias, registar despesas, ver documentos e tratar aprovações.
- Login com a conta Selfcare e escolha da empresa, sem chaves para copiar
- O assistente vê só o que a pessoa vê, com os mesmos âmbitos e limites da API
- Cada ação fica no registo de auditoria da empresa, marcada como vinda do assistente
- Revogas o acesso quando quiseres em Definições → API
API REST: férias, despesas, documentos e pessoas
Lê e escreve o que a tua equipa faz no Selfcare a partir do ERP, do software de ponto, do BI ou de uma ferramenta tua.
- Ausências e saldos de férias, aprovações, despesas com recibo, ajudas de custo e documentos
- Colaboradores, equipas, contratos e remuneração, com âmbitos sensíveis só para o dono e o RH
- Chaves pessoais com âmbitos à escolha, ou OAuth 2.1 com PKCE para apps usadas por várias pessoas
- Empresa de teste com dados fictícios e chaves próprias para desenvolver sem tocar em dados reais
Uma app móvel tua, com férias, despesas e notificações
Tudo o que precisas para uma app de colaborador: login nativo, notificações e um ecrã inicial numa só chamada.
- Login nativo com OAuth 2.1 e PKCE, tokens que rodam em cada renovação
- Notificações push quando uma ausência ou despesa é decidida, sem nomes nem valores no ecrã bloqueado
- Resumo para o ecrã inicial: saldo, próximas ausências, aprovações e documentos por ler
- Despesa com a fotografia do recibo, enviada diretamente para armazenamento seguro
Webhooks: sabe na hora quando algo muda
O teu servidor recebe um aviso assinado quando uma ausência é aprovada, uma despesa é paga ou um colaborador muda.
- Mais de 30 eventos: ausências, despesas, deslocações, documentos, pessoas e equipas
- Assinatura HMAC com carimbo temporal e repetições automáticas durante 24 horas
- O aviso leva só ids e estados: o resto lê-se pela API, com as permissões de quem o configurou
Segurança e controlo
A API foi desenhada para dados de RH. O dono e o RH têm sempre a última palavra.
- Isolamento por empresa na base de dados, como na app
- Chaves guardadas só como hash, mostradas uma vez, revogadas ao mudar a palavra-passe
- Bloqueio de emergência da API inteira, pelo dono ou pelo RH
- Limites por chave, por empresa e por app, com cabeçalhos claros
- Dados alojados na União Europeia
Procuras uma integração pronta?
A Coverflex já entra no recibo sem redigitação, e há mais ligações a caminho.
Perguntas sobre a API
A API tem custo?+
Não. A API, os webhooks e o servidor MCP estão incluídos em todos os planos.
Posso ler salários ou recibos de vencimento?+
O processamento salarial fica fora da API e do MCP. Pela API, cada pessoa vê os seus recibos já emitidos, como na app; pelo MCP, recibos, contratos e documentos de identificação nunca saem.
Quem pode criar chaves?+
Qualquer pessoa da empresa, para si, com o que o seu papel permite. O dono e o RH veem e revogam todas as chaves.
Que assistentes de IA funcionam com o Selfcare?+
Qualquer cliente MCP com OAuth, como o Claude, o ChatGPT ou o Cursor. Quem não faz OAuth pode usar uma chave pessoal.
Há um ambiente de testes?+
Sim. Crias uma empresa de teste com dados fictícios e chaves próprias, sem tocar nos dados reais.
Começa pela documentação
Guias, exemplos em curl e TypeScript e a referência completa, em português e inglês.