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/catalogoKIN_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/datasKIN_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/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"
]
}'Abra o link temporário
A Kinology gera ou reaproveita o PDF equivalente e retorna REFERENCIA_RELATORIO, URL_PDF e EXPIRA_EM com o envelope. O ticket dura até sete dias, limitado pela credencial e retenção do documento. Abra URL_PDF diretamente e permita o redirecionamento 302. Não envie Bearer no resgate.
GET/documentos/acesso/solicitado/{TOKEN}KIN_BASE_URL=https://api.exemplo.invalid
curl -L -X GET "$KIN_BASE_URL/v7/integracoes/documentos/acesso/solicitado/TICKET_SINTETICO_NAO_UTILIZAVEL"Proteja o acesso ao documento
Trate URL_PDF como segredo temporário. Mantenha fora de logs, analytics, URLs intermediárias e armazenamento persistente no cliente. Após expiração ou ARTEFATO_AUSENTE / ARTEFATO_ALTERADO, repita o pedido para obter novo arquivo ou acesso. Em PDF_EM_GERACAO, retente o mesmo pedido com espera e limite.
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