Exemplo de integração
Um exemplo genérico com dados sintéticos, sem representar organizações ou pessoas reais.
Cada sistema com seu papel
O sistema integrador mantém seus próprios usuários, vínculos e autorizações. A Kinology recebe o cadastro como paciente associado à conta autorizada. O avaliador é definido na Kinology e utiliza o aplicativo de avaliação.
Use o código do paciente
Mantenha 00158 como string em METADADOS.ID_REFERENCIA_EXTERNA. Não deduplique por nome. Antes de cadastrar, consulte a referência externa. Caso exista, use a versão atual para atualizar somente os campos necessários.
GET/contas/{CONTA}/pacientes/referencia_externa/{EXTERNA}KIN_BASE_URL=https://api.exemplo.invalid
curl -X GET "$KIN_BASE_URL/v7/integracoes/contas/cta_0123456789abcdef0123456789abcdef/pacientes/referencia_externa/00158" \
-H 'Authorization: Bearer <API_KEY>' \
-H 'X-Correlation-ID: INTEGRACAO-EXEMPLO-001'Peça o recorte desejado
Para o paciente 00158, consulte datas, selecione 2026-11-18 e as seções ANAMNESE e EVA disponíveis. Solicite o PDF e abra URL_PDF diretamente. O sistema integrador deve validar a autorização do destinatário antes de disponibilizar o documento.
POST/contas/{CONTA}/pacientes/referencia_externa/{EXTERNA}/relatorios/pdfKIN_BASE_URL=https://api.exemplo.invalid
curl -X POST "$KIN_BASE_URL/v7/integracoes/contas/cta_0123456789abcdef0123456789abcdef/pacientes/referencia_externa/00158/relatorios/pdf" \
-H 'Authorization: Bearer <API_KEY>' \
-H 'X-Correlation-ID: INTEGRACAO-EXEMPLO-001' \
-H 'Content-Type: application/json' \
--data '{
"PERIODO": {
"INICIO": "2026-11-18",
"FIM": "2026-11-18"
},
"SECOES": [
"ANAMNESE",
"EVA"
]
}'