KinologydevelopersReferência da API v1.0
COMECE AQUI

Sua primeira integração

Do primeiro cadastro ao PDF. Conecte seu sistema à Kinology com um contrato simples, seguro e feito para parceiros.

Antes de começar

Solicite uma credencial de integração à Kinology e confirme o ambiente, as contas concedidas e suas permissões. Provisionamento e rotação são tratados com a equipe Kinology. A disponibilidade de rotas no ambiente precisa ser confirmada separadamente do contrato.

Um fluxo, seis passos

Obter credencial → listar contas → cadastrar ou localizar paciente → consultar catálogo e datas → solicitar PDF → abrir URL_PDF diretamente. O laboratório demonstra essa sequência sem conectar à API.

Liste as contas autorizadas

Envie Authorization: Bearer <API_KEY> para GET /v7/integracoes/contas. Escolha REFERENCIA_CONTA na resposta e confira PERMISSOES. Uma única credencial pode autorizar múltiplas contas, cada uma com capacidades próprias.

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

Cadastre e consulte o paciente

Use o código externo exato do seu sistema. Neste exemplo, 00158 continua sendo uma string, com seus zeros iniciais. Consulte as datas disponíveis, escolha as seções e solicite o PDF. Abra o link antes de EXPIRA_EM.

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