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.
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Exige ao menos uma das permissões create_preconsultations, update_preconsultations, create_consultations, update_consultations.
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
| Campo | Tipo | Obrigatório | Valores válidos | Descrição |
|---|---|---|---|---|
patientId | number | ✅ | inteiro | ID do paciente |
denies | boolean | ❌ | true ou false | O paciente nega ter alergias. Não pode ser true se o paciente já tem alergia em aberto ou se vieram alergias novas |
preConsultationId | number | ❌ | inteiro | Pré-consulta em que a conferência foi feita. Define a origem das alergias novas (PRE_CONSULTATION); sem ele, a origem é CONSULTATION |
consultationId | number | ❌ | inteiro | Consulta em que a conferência foi feita |
allergies | object[] | ❌ | até 20 itens | Alergias novas |
allergies[].substance | string | ✅ | até 120 caracteres; não vazio | Substância |
allergies[].reaction | string | ❌ | até 500 caracteres | Reação |
allergies[].severity | string | ❌ | MILD, MODERATE ou SEVERE | Gravidade |
disputes | object[] | ❌ | até 20 itens | Alergias já registradas que o paciente contesta |
disputes[].allergyId | number | ✅ | inteiro; alergia em aberto do paciente | ID da alergia contestada |
disputes[].note | string | ✅ | até 500 caracteres; não vazio | O 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 alergiasAlergia contestada não pertence ao pacienteAtendimento não pertence ao paciente(preConsultationIdouconsultationIdde 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
}