Quickstart em 5 minutos

Conecte sua operação à Plataforma Fhinck em 4 passos. Ao final você terá enviado seu primeiro colaborador para a Plataforma de Inteligência e Orquestração Operacional.

Tempo estimado: 5 minutos. Você vai precisar apenas de um cliente HTTP (cURL, Postman, ou scripts em Node/Python/C#) e o e-mail do responsável técnico da empresa.

Passo 1 — Obter sua chave de integração

Envie um e-mail para contato@fhinck.com informando:

Nome da empresa
E-mail do responsável técnico
Ambiente desejado (produção ou homologação — empresas com HOMOLOG no nome não disparam e-mails reais)

Você receberá uma key criptografada única. Guarde-a em variável de ambiente — nunca commit no código-fonte.

Variável de ambiente

export FHINCK_KEY="SUA_CHAVE_DE_INTEGRACAO"

Passo 2 — Validar sua chave

Antes de integrar qualquer fluxo, confirme que a chave está válida. Use o endpoint /integrationValidatorData:

Prefere uma interface visual? Use o Validador de Integração para conferir os dados sincronizados sem escrever uma linha de código.

cURL — validar key

curl -X POST https://integrations.fhinck.com/integrationValidatorData \
  -H "Content-Type: application/json" \
  -d "{ \"key\": \"$FHINCK_KEY\" }"

JavaScript (fetch)

const res = await fetch('https://integrations.fhinck.com/integrationValidatorData', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ key: process.env.FHINCK_KEY }),
});

const data = await res.json();
if (data.err) throw new Error('Chave inválida: ' + data.message);
console.log('Chave válida');

Python (requests)

import os, requests

resp = requests.post(
    'https://integrations.fhinck.com/integrationValidatorData',
    json={'key': os.environ['FHINCK_KEY']},
    timeout=30,
)
body = resp.json()
if body.get('err'):
    raise RuntimeError('Chave inválida: ' + body['message'])
print('Chave válida')

Rate limit: /integrationValidatorData aceita no máximo 10 requisições por minuto por IP. Use apenas para diagnóstico, não em loop de produção.

Passo 3 — Fazer sua primeira chamada

Envie seu primeiro colaborador via POST /masterData. Este é o envio mais básico — apenas key + um employee com campos obrigatórios:

cURL — primeiro envio

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

JavaScript (fetch)

const res = await fetch('https://integrations.fhinck.com/masterData', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    key: process.env.FHINCK_KEY,
    data: {
      employees: [
        {
          login: 'joao.silva',
          name: 'João Silva',
          department: 'COORD',
          role: 'ANALISTA',
          active: true,
        },
      ],
    },
  }),
});

const data = await res.json();
if (data.err) throw new Error(data.message);
console.log('Colaborador sincronizado:', data.message);

Python (requests)

import os, requests

payload = {
    'key': os.environ['FHINCK_KEY'],
    'data': {
        'employees': [
            {
                'login': 'joao.silva',
                'name': 'João Silva',
                'department': 'COORD',
                'role': 'ANALISTA',
                'active': True,
            },
        ],
    },
}

resp = requests.post('https://integrations.fhinck.com/masterData', json=payload, timeout=30)
body = resp.json()
if body.get('err'):
    raise RuntimeError(body['message'])
print('Colaborador sincronizado:', body.get('message'))

Resposta esperada (200):

Response 200

{
  "err": false,
  "message": "Atualização concluída com sucesso!"
}

Passo 4 — Próximos passos

Com a primeira chamada funcionando, escolha o próximo fluxo para integrar:

Problemas comuns

Sintoma	Causa provável	Ação
HTTP 400 com `MISSING_KEY`	Variável de ambiente não carregou.	Verifique `echo $FHINCK_KEY` antes de executar.
HTTP 401 com `INVALID_KEY`	Chave truncada ou re-codificada.	Compare tamanho da chave com a original no e-mail.
HTTP 422	Campos obrigatórios ausentes (`login`, `name`, `department`, `role`, `active`).	Confira a mensagem `message` na resposta.
HTTP 429	Muitas chamadas ao validator em curto período.	Aguarde 1 minuto e retente. Use validator apenas para diagnóstico.

Preso em algum passo? Envie um e-mail para contato@fhinck.com com o erro exato e o cURL usado. O time Fhinck responde rapidamente.

Quickstart em 5 minutos

Passo 1 — Obter sua chave de integração

Passo 2 — Validar sua chave

Passo 3 — Fazer sua primeira chamada

Passo 4 — Próximos passos

Master Data completo

Controle de Ponto

Extensão de Jornada

Notificações

Classificação de Apps

Tratamento de erros

Problemas comuns