KinologydevelopersReferência da API v1.0
EXEMPLO GENÉRICO

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}
cURL
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/pdf
cURL
KIN_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"
  ]
}'
Todos os exemplos são sintéticos. Execute chamadas reais somente no seu servidor, em ambiente autorizado.
Experimentar no laboratório