Busca e paginação
Percorra associações por cursor e mantenha uma sincronização incremental previsível.
Combine filtros explícitos
A busca recebe FILTROS e PAGINACAO. Suporta ID_REFERENCIA_EXTERNA, CRIADO_EM_DE, CRIADO_EM_ATE, ATUALIZADO_EM_DE e ATUALIZADO_EM_ATE, combinados por E. Use timestamps UTC terminados em Z: início inclusivo e fim exclusivo. Por exemplo, novembro usa 2026-11-01T00:00:00Z até 2026-12-01T00:00:00Z.
POST/contas/{CONTA}/pacientes/buscarKIN_BASE_URL=https://api.exemplo.invalid
curl -X POST "$KIN_BASE_URL/v7/integracoes/contas/cta_0123456789abcdef0123456789abcdef/pacientes/buscar" \
-H 'Authorization: Bearer <API_KEY>' \
-H 'X-Correlation-ID: INTEGRACAO-EXEMPLO-001' \
-H 'Content-Type: application/json' \
--data '{
"FILTROS": {
"ATUALIZADO_EM_DE": "2026-11-01T00:00:00Z",
"ATUALIZADO_EM_ATE": "2026-12-01T00:00:00Z"
},
"PAGINACAO": {
"LIMITE": 20,
"CURSOR": null
}
}'Continue com o mesmo escopo
Padrão 20 itens; LIMITE entre 1 e 100. A ordem é crescente por atualização e referência pública. Use PAGINACAO.PROXIMO_CURSOR mantendo conta e filtros. TEM_MAIS: N e cursor null indicam fim. Cursor é opaco: não decodifique nem altere. Ao mudar conta ou filtros, reinicie sem cursor.
Sem resultados
PACIENTES: [] é uma resposta válida. A busca retorna somente associações autorizadas. As datas clínicas usam outro cursor, até 20 datas decrescentes por página e filtros de data civil inclusivos. Não misture os dois tipos de paginação.