Autenticação e escopos
Uma credencial de integração. Permissões explícitas em cada conta.
Autenticação Bearer
Envie Authorization: Bearer <API_KEY> nas rotas autenticadas. A chave deve ficar no servidor do integrador. Nunca em bundles, query strings ou links de PDF. Não use o token de sessão do aplicativo. Solicite emissão e rotação à Kinology.
Contas e permissões
GET /contas retorna REFERENCIA_CONTA e PERMISSOES. PACIENTES_LER permite consulta e busca; PACIENTES_ESCREVER permite sincronização, importação e modelo; RELATORIOS_LER permite catálogo e datas; RELATORIOS_PDF_LER permite pedir PDF. O resgate revalida as concessões atuais.
GET/contasKIN_BASE_URL=https://api.exemplo.invalid
curl -X GET "$KIN_BASE_URL/v7/integracoes/contas" \
-H 'Authorization: Bearer <API_KEY>' \
-H 'X-Correlation-ID: INTEGRACAO-EXEMPLO-001'Rastreie a operação
X-Correlation-ID é opcional: 1–100 caracteres ASCII alfanuméricos, ponto, hífen ou underscore. Sem header, a API gera um UUID. ID_CORRELACAO no body é alias opcional; divergência com o header retorna 400. Não inclua dados pessoais. X-Request-ID e ID_REQUISICAO identificam a tentativa HTTP.
Formato de envio
Envie JSON com Content-Type: application/json, sem compressão, até 192 KiB e dentro de 10 segundos. Campos desconhecidos são rejeitados. O ticket de PDF dispensa Bearer porque o próprio link é um segredo temporário.