Skip to main content

POST Registrar Conferência de Alergias

Registra a conferência de alergias feita com o paciente, junto com as alergias novas e as contestações da mesma conferência, em uma transação. O resultado da conferência é NEW_ALLERGY (há alergia nova), NO_ALLERGIES (denies: true) ou NO_CHANGES.

Alergias novas registradas na pré-consulta (com preConsultationId) ficam PENDING até o médico confirmar; as registradas na consulta (sem preConsultationId) já nascem ACTIVE e confirmadas por quem registrou.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Permissão necessária

Exige ao menos uma das permissões create_preconsultations, update_preconsultations, create_consultations, update_consultations.

Só usuário

Grava o responsável pela conferência: com API Key a rota responde 403.


Endpoint​

POST https://api-dev.imagemais.com.br/api/patient-allergies/reviews

Corpo da Requisição​

CampoTipoObrigatórioValores válidosDescrição
patientIdnumber✅inteiroID do paciente
deniesboolean❌true ou falseO paciente nega ter alergias. Não pode ser true se o paciente já tem alergia em aberto ou se vieram alergias novas
preConsultationIdnumber❌inteiroPré-consulta em que a conferência foi feita. Define a origem das alergias novas (PRE_CONSULTATION); sem ele, a origem é CONSULTATION
consultationIdnumber❌inteiroConsulta em que a conferência foi feita
allergiesobject[]❌até 20 itensAlergias novas
allergies[].substancestring✅até 120 caracteres; não vazioSubstância
allergies[].reactionstring❌até 500 caracteresReação
allergies[].severitystring❌MILD, MODERATE ou SEVEREGravidade
disputesobject[]❌até 20 itensAlergias já registradas que o paciente contesta
disputes[].allergyIdnumber✅inteiro; alergia em aberto do pacienteID da alergia contestada
disputes[].notestring✅até 500 caracteres; não vazioO que o paciente disse (ex.: "Tomou dipirona este ano e não teve reação")

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/patient-allergies/reviews' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"patientId": 1234,
"preConsultationId": 301,
"allergies": [
{
"substance": "Ibuprofeno",
"reaction": "Inchaço nos olhos",
"severity": "MODERATE"
}
],
"disputes": [
{
"allergyId": 88,
"note": "Tomou dipirona este ano e não teve reação"
}
]
}'

Respostas​

201 Sucesso​

{
"id": 17,
"accountId": 1,
"patientId": 1234,
"result": "NEW_ALLERGY",
"preConsultationId": 301,
"consultationId": null,
"reviewedByUserId": 12,
"createdAt": "2026-11-05T13:00:00.000Z"
}

400 Requisição inválida​

Mensagens possíveis, além das de validação:

  • O paciente tem alergias registradas. Conteste as que ele nega em vez de marcar que não tem alergias
  • Alergia contestada não pertence ao paciente
  • Atendimento não pertence ao paciente (preConsultationId ou consultationId de outro paciente)
{
"message": "Alergia contestada não pertence ao paciente",
"error": "Bad Request",
"statusCode": 400
}

403 Sem permissão​

Além de Permissões insuficientes, a rota responde assim quando chamada com API Key (sem usuário).

{
"message": "Ação disponível apenas para usuários autenticados",
"error": "Forbidden",
"statusCode": 403
}

404 Não encontrado​

{
"message": "Paciente não encontrado",
"error": "Not Found",
"statusCode": 404
}