POST Sugerir Alergias de um Texto
A IA lê um texto livre (por exemplo, o motivo da pré-consulta) e devolve as alergias que o paciente cita ter e que ainda não estão registradas. Nada é gravado: a sugestão serve para a enfermagem confirmar e registrar pela conferência. Não entram negações, alergias de familiares nem remédios só usados.
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.
Endpoint
POST https://api-dev.imagemais.com.br/api/patient-allergies/suggestions
Corpo da Requisição
| Campo | Tipo | Obrigatório | Valores válidos | Descrição |
|---|---|---|---|---|
patientId | number | ✅ | inteiro | ID do paciente |
text | string | ✅ | até 4000 caracteres | Texto livre da pré-consulta, como o motivo |
Requisição
curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/patient-allergies/suggestions' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"patientId": 1234,
"text": "Dor de garganta. Diz que é alérgica a amoxicilina, deu manchas no corpo."
}'
Respostas
201 Sucesso
{
"suggestions": [
{
"substance": "Amoxicilina",
"reaction": "Manchas no corpo",
"excerpt": "alérgica a amoxicilina, deu manchas no corpo"
}
]
}
Texto com menos de 10 caracteres, falha da IA ou nenhuma alergia nova resultam em { "suggestions": [] }. reaction e excerpt são null quando o texto não os traz.
400 Requisição inválida
Retornado quando o corpo ou a query não passam na validação. A lista message traz um item por regra violada, por exemplo:
{
"message": [
"patientId must be an integer number",
"text must be shorter than or equal to 4000 characters"
],
"error": "Bad Request",
"statusCode": 400
}
403 Sem permissão
{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}
404 Não encontrado
{
"message": "Paciente não encontrado",
"error": "Not Found",
"statusCode": 404
}