Integrações/Laudos e imagens
Homologação

Laudos e imagens

Formatos de laudo, anexos, viewer e liberação.

Necessidade Comportamento
Consultar o exame GET /v1/exam/:accessionNumber
Obter o PDF A resposta padrão usa uma URL assinada quando há PDF; format: pdf devolve base64
Obter o corpo do laudo format: html, rtf ou text; base64: false devolve o texto desses formatos
Agrupar laudos associados group: true com format: pdf retorna um PDF único
Enviar laudo externo POST /v1/exam/:accessionNumber/report; formato e campos conforme OpenAPI
Enviar anexos JPEG, PNG, GIF, BMP e PDF; até 1 MB por arquivo e 20 por chamada
Consultar o viewer GET /v1/viewer/:accessionNumber
Acesso médico A opção forMedic seleciona o acesso médico, inclusive antes do laudo
Reter resultado do paciente release: false impede a disponibilização nos canais de paciente; o acesso autorizado da equipe e do médico continua disponível

O PDF agrupado é uma compilação para leitura e não herda a validação criptográfica das assinaturas dos PDFs originais. URLs assinadas têm validade limitada; não devem ser tratadas como endereços permanentes.

Formatos de retorno

  • PDF: laudo completo, com cabeçalho e rodapé da unidade e assinatura do médico executante. Sem o header format, GET /v1/exam/:acc devolve em report.content a URL assinada do PDF (validade de 1 hora); com format: pdf, o PDF em base64;
  • HTML / RTF / Texto puro (format: html|rtf|text): apenas o corpo do laudo; demais informações são tratadas dentro do software do terceiro. Em base64 por padrão (base64: false devolve o texto);
  • group: true agrupa os laudos disponíveis das cópias em um único corpo sequencial. Com format: pdf, report.content contém um PDF único em base64 (inclusive com base64: false), com páginas ordenadas por criação/id do exame, sem duplicatas. Um único PDF mantém os bytes originais; PDF armazenado ilegível ou sem páginas faz a leitura falhar. Se o exame solicitado não tem laudo, os metadados usam o primeiro disponível do grupo. Sem laudos, retorna ausência.
  • O PDF agrupado é uma compilação de leitura: não herda a validação criptográfica das assinaturas dos originais. Os arquivos e registros originais permanecem intactos. No perfil mobilemed não há groupedContent; legacy conserva essa extensão deprecated, que não deve ser anexada novamente a content.
  • GIF/BMP aceitos na API e no upload interno mantêm bytes e MIME originais para preview/download. Promoção e citação usam uma derivada PNG reutilizável no PDF; GIF citado mostra o primeiro quadro composto, enquanto o original continua animado. Rotação só está disponível para PNG/JPEG.