MEDIAG × HTP — API Hospitalar

Documentação interativa OpenAPI 3.0 · v1.0 · Modelo PULL

MEDIAG × HTP — Hospital Integration API
 1.0 
OAS 3.0

API de integração entre a MEDIAG (Acura Lab) e o HTP (Hospital Privado de Talatona, sistema de origem Docbase). Permite cadastrar pacientes, submeter requisições de exames, consultar estados e descarregar laudos PDF.

Modelo PULL: o HTP consulta os resultados via API (polling). A MEDIAG não envia webhooks.

Autenticação dupla: todas as chamadas enviam dois headers:

  • X-API-Key — credencial atribuída ao HTP (formato: htp_live_...)
  • X-Signature — HMAC-SHA256 do raw body (corpo cru) usando o hmac_secret da credencial. Em GET (sem body), assine uma string vazia "".

Idempotência: o campo requisicao_externa_id garante que requisições duplicadas retornam os dados da existente (não criam duplicados).

Servers

Pacientes

Cadastro e atualização de pacientes (upsert).

Requisições

Submissão e consulta de requisições de exames.

Resultados

Download de laudos em PDF.