Skip to main content

POST Vincular Nomes de Exames a Procedimentos

Para cada nome de exame enviado, devolve o procedimento do catálogo da clínica com o mesmo nome (sem diferenciar maiúsculas, espaços extras e acentos) ou, na falta dele, o mais parecido por semelhança, quando a confiança é alta. Sem confiança — ou com mais de um procedimento de mesmo nome —, procedureId vem null. Não grava nada.

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 a permissão read_procedures.


Endpoint​

POST https://api-dev.imagemais.com.br/api/procedures/match

Corpo da Requisição​

CampoTipoObrigatórioValores válidosDescrição
namesstring[]✅de 1 a 50 itens; cada um não vazio, com até 500 caracteresNomes de exames para procurar no catálogo

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/procedures/match' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"names": [
"Hemograma completo",
"Ultrassom de abdome total"
]
}'

Respostas​

201 Sucesso​

[
{
"name": "Hemograma completo",
"procedureId": 42
},
{
"name": "Exame sem correspondência",
"procedureId": null
}
]

O resultado segue a ordem de names. A busca por semelhança usa IA (embeddings); se ela falhar, a rota continua e devolve só as correspondências por nome exato.

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": [
"names must contain at least 1 elements",
"each value in names must be shorter than or equal to 500 characters"
],
"error": "Bad Request",
"statusCode": 400
}

403 Sem permissão​

{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}