Skip to main content

POST Download do PDF do Exame

Faz o download do arquivo PDF de um exame a partir do seu UUID.

Rota pública

Esta rota é marcada como @IsPublic() — não exige Authorization nem x-api-key.

Obtendo o UUID

O uuid é retornado pelo endpoint Buscar Pedidos de Exames no campo patientExams.uuid.


Endpoint​

POST https://api-dev.imagemais.com.br/api/results/{uuid}/download

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
uuidstring (uuid)✅UUID do pedido de exame

Corpo da Requisição​

CampoTipoObrigatórioDescrição
cpfstring✅CPF do paciente dono do exame (11 dígitos, sem máscara)
dateBirthstring✅Data de nascimento do paciente (YYYY-MM-DD)
Validação de titularidade

Desde a versão atual, o PDF só é liberado quando cpf e dateBirth correspondem ao paciente dono do exame. Para uso interno (prontuário), existe a variante autenticada /api/results/exam/{uuid}/download, isolada pela conta do token e sem CPF.


Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/results/{uuid}/download' \
-H 'accept: */*' \
-H 'Content-Type: application/json' \
-d '{
"cpf": "{cpf}",
"dateBirth": "{dateBirth}"
}'

Respostas​

200 Sucesso​

Retorna o conteúdo binário do arquivo PDF para visualização ou download direto.

Content-Type: application/pdf
Body: <conteúdo binário do arquivo>

O header Content-Disposition: attachment; filename=... define o nome do arquivo.

400 CPF ou data de nascimento ausentes​

{
"message": [
"O cpf é necessário",
"cpf must be a string",
"A data de nascimento é obrigatório"
],
"error": "Bad Request",
"statusCode": 400
}

400 Paciente não confere ou exame não encontrado​

Retornado quando não existe paciente com esse CPF e data de nascimento ("Paciente não encontrado ou dados incorretos") ou quando o UUID não existe / não pertence a esse paciente:

{
"message": "Nenhum exame encontrado com esse UUID",
"error": "Bad Request",
"statusCode": 400
}

400 Laudo não liberado​

Retornado quando o exame existe e pertence ao paciente, mas o laboratório ainda não liberou o laudo.

{
"message": "[IMGM-a100c699-fe1b-4ec0-9f63-0acc49e94308] Laudo não liberado pelo laboratório",
"error": "Bad Request",
"statusCode": 400
}

500 Falha ao obter o arquivo​

Retornado quando o PDF não pode ser gerado ou lido do storage. A mensagem é a do erro interno.