A conclusão que orienta todo o uso

O código analisado comprova publicação FHIR, mas não comprova que os mesmos endereços ofereçam pesquisa FHIR.

EvidênciaConclusão segura
POST e PUT no código do conectorOs destinos configurados são comprovadamente usados para escrita
Ausência de GET FHIR no códigoNão afirmar que o conector pesquisa recursos FHIR
GET de laudo no AGHURecuperação do PDF ocorre antes da montagem do Bundle e não prova leitura FHIR
Parâmetros de busca da especificação R4São possibilidades que dependem do suporte declarado pelo servidor

Fluxos e recursos envolvidos

Os modelos do conector usam estratégias diferentes conforme o conteúdo de origem.

FluxoPublicação observadaRecursos principais
Agendamento presencial ou teleconsultaAtualização de recurso individualAppointment
Resultado de exameBundle transacional em FHIR JSONDiagnosticReport, ServiceRequest e Binary
RAC, RAC 4.2, Sumário de Alta e anexosBundle documental MHD em FHIR XMLPatient, Practitioner, DocumentManifest, DocumentReference e Binary
Paciente e profissional no fluxo cadastralMensageria PIX/HL7v3Não corresponde a FHIR REST no envio primário
PDF do laudoLeitura na API AGHUConteúdo convertido para o anexo do resultado

Como validar um endpoint de leitura

A descoberta deve acontecer antes de implementar consultas ou assumir parâmetros disponíveis.

  1. 1
    Identificar o serviço correto

    Confirmar com a infraestrutura qual base FHIR está destinada a consultas e em qual ambiente o teste é permitido.

  2. 2
    Ler o CapabilityStatement

    Consultar os metadados do servidor autenticado e verificar versão FHIR, formatos e recursos expostos.

  3. 3
    Conferir interações

    Validar read e search-type para cada recurso, sem inferir capacidade a partir de outro recurso.

  4. 4
    Conferir parâmetros

    Usar apenas searchParams declarados e confirmar modificadores, buscas encadeadas e _include.

  5. 5
    Testar com dados controlados

    Executar em ambiente autorizado, sem dados pessoais em logs, e registrar resposta, paginação e OperationOutcome.

Mapa conceitual de pesquisas

Quando declarados pelo servidor, estes são os critérios mais úteis para os recursos produzidos.

RecursoCritérios candidatosCuidados
AppointmentIdentificador, paciente, período, status e tag organizacionalAtores contidos podem limitar pesquisas independentes
DiagnosticReportIdentificador, paciente, emissão, status, tag e solicitaçãoCategoria pode estar ausente na carga atual
ServiceRequestIdentificador, requisição, paciente, autoria, status e encounterDistinguir solicitação inteira de item de exame
DocumentReferenceIdentificador, paciente, tipo, período, autor, MIME e statusO conteúdo clínico pode estar no Binary associado
DocumentManifestIdentificador, paciente, criação, origem, tipo e itemConfirmar suporte do servidor e versão do perfil MHD
Patient e PractitionerID físico ou identificador de negócioDisponibilidade depende do processamento da plataforma

Limites que evitam respostas incorretas

Algumas referências no payload parecem pesquisáveis, mas não representam recursos autônomos.

  • Recursos contidos não possuem URL REST independente e normalmente não podem ser pesquisados como instâncias autônomas.
  • Uma referência condicional em um Bundle é uma instrução de escrita; não prova que o conector executou uma consulta GET.
  • A presença de uma propriedade de configuração não comprova seu uso em uma chamada HTTP.
  • A classificação implícita de um perfil não garante o preenchimento do elemento de categoria pesquisável.
  • Identificadores devem ser tratados como dados controlados; exemplos reais não pertencem ao portal público.