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

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/buscar
cURL
KIN_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.

Todos os exemplos são sintéticos. Execute chamadas reais somente no seu servidor, em ambiente autorizado.
Experimentar no laboratório