KinologydevelopersReferência da API v1.0
GUIAS DE INTEGRAÇÃO

Das datas ao PDF

Escolha o recorte clínico e obtenha um acesso temporário ao documento.

Consulte o catálogo

Use os códigos atuais em SECOES. O catálogo informa FORMATOS, limites da importação e PDF.TTL_PADRAO_SEGUNDOS / TTL_MAXIMO_SEGUNDOS. A validade efetiva pode ser menor; use EXPIRA_EM da solicitação como fonte de verdade.

GET/contas/{CONTA}/relatorios/catalogo
cURL
KIN_BASE_URL=https://api.exemplo.invalid
curl -X GET "$KIN_BASE_URL/v7/integracoes/contas/cta_0123456789abcdef0123456789abcdef/relatorios/catalogo" \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'X-Correlation-ID: INTEGRACAO-EXEMPLO-001'

Encontre as datas disponíveis

Consulte pelo código externo. Sem filtros, recebe as 20 datas mais recentes encontradas. DATA_DE e DATA_ATE são opcionais, YYYY-MM-DD e inclusivas. Use PROXIMO_CURSOR mantendo os mesmos filtros. DATAS: [] indica ausência de dados na projeção; a disponibilidade reflete seu ciclo de atualização.

GET/contas/{CONTA}/pacientes/referencia_externa/{EXTERNA}/relatorios/datas
cURL
KIN_BASE_URL=https://api.exemplo.invalid
curl -X GET "$KIN_BASE_URL/v7/integracoes/contas/cta_0123456789abcdef0123456789abcdef/pacientes/referencia_externa/00158/relatorios/datas" \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'X-Correlation-ID: INTEGRACAO-EXEMPLO-001'

Escolha período e seções

Envie PERIODO.INICIO e FIM com até 31 dias inclusivos. Para um dia, repita a data. Selecione uma ou mais SECOES válidas, sem duplicatas, considerando SECOES_DISPONIVEIS. Em 422 SEM_DADOS_PDF, SECAO_INDISPONIVEL ou VOLUME_EXCEDIDO, revise as seções ou reduza a janela.

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"
  ]
}'

Códigos de seções

TRIAGEM
Triagem
ANAMNESE
Anamnese
ATENDIMENTO
Atendimento
PREENSAO_PALMAR
Preensão palmar
ASSIMETRIA
Assimetria
EQUILIBRIO_MUSCULAR
Equilíbrio muscular
EVA
Escala visual analógica
SF_36
Qualidade de vida (SF-36)
PROGRESSAO_FORCA
Progressão de força
CURVAS_FORCA
Curvas de força
Todos os exemplos são sintéticos. Execute chamadas reais somente no seu servidor, em ambiente autorizado.
Experimentar no laboratório