Skip to main content

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.

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.


Endpoint​

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

Corpo da Requisição​

CampoTipoObrigatórioValores válidosDescrição
patientIdnumber✅inteiroID do paciente
textstring✅até 4000 caracteresTexto 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
}