API de Integração
Fhinck

Conecte sua operação à Plataforma de Inteligência e Orquestração Operacional. Task Mining alimenta a inteligência operacional em tempo real — Master Data, Controle de Ponto e Notificações completam o circuito, em minutos.

Quickstart em 5 min Ver Documentação

Integrações disponíveis

Escolha a integração que melhor se adapta à sua operação.

Comece em 3 passos

Integrações prontas em minutos, sem dependências externas.

Solicite sua chave de integração

Envie um e-mail para contato@fhinck.com informando o nome da empresa. Você receberá uma key criptografada única.

Valide sua chave

Teste autenticação com o endpoint integrationValidatorData:

cURL — validar key
curl -X POST https://integrations.fhinck.com/integrationValidatorData \
  -H "Content-Type: application/json" \
  -d '{ "key": "SUA_CHAVE_DE_INTEGRACAO" }'

Faça sua primeira chamada

Envie um cadastro mínimo de colaborador via POST /masterData:

cURL — primeiro envio
curl -X POST https://integrations.fhinck.com/masterData \
  -H "Content-Type: application/json" \
  -d '{
    "key": "SUA_CHAVE_DE_INTEGRACAO",
    "data": {
      "employees": [
        { "login": "joao.silva", "name": "João Silva", "department": "COORD", "role": "ANALISTA", "active": true }
      ]
    }
  }'

Dúvidas frequentes

Respostas rápidas para as perguntas mais comuns sobre a API.

A chave é gerada pelo time Fhinck e entregue ao responsável técnico da empresa durante o processo de onboarding. Cada empresa recebe uma chave única e criptografada. Para solicitar, envie e-mail para contato@fhinck.com.
Recomendamos o envio diário de deltas — apenas os registros que foram criados, atualizados ou desativados. O endpoint /masterData é idempotente: enviar o mesmo registro duas vezes não gera duplicidade.
A API retorna HTTP 400 com {"err": true, "message": "Parametro key não informado ou inválido"}. Verifique se a chave não foi truncada ou modificada durante a transmissão.
Sim. Todos os endpoints de integração (Master Data, Controle de Ponto, Extensão, Notificações, Classificação de Apps) usam o mesmo campo key no body da requisição. Cada empresa tem uma chave única e exclusiva.
Sim. Empresas cadastradas com "HOMOLOG" no nome não disparam e-mails de aprovação, e o campo approvalLinkKey retorna null. Solicite ao time Fhinck a criação de um ambiente de homologação.