Uploaded image for project: 'FHIR Specification Feedback'
  1. FHIR Specification Feedback
  2. FHIR-30577

Is search via POST a required server feature?

    XMLWordPrintableJSON

Details

    • Icon: Change Request Change Request
    • Resolution: Persuasive
    • Icon: Medium Medium
    • FHIR Core (FHIR)
    • R4
    • FHIR Infrastructure
    • Search
    • 3.1.0.9
    • Hide

      We've clarified in the thread that this does apply to US Core too.  We will also create a tracker to ensure this is made clear in the US Core spec.  We will update the tooling for both FHIR Core and IGs to ensure that the OpenAPI interface includes the _search endpoint where a CapabilityStatement indicates support for the search operation.

      Show
      We've clarified in the thread that this does apply to US Core too.  We will also create a tracker to ensure this is made clear in the US Core spec.  We will update the tooling for both FHIR Core and IGs to ensure that the OpenAPI interface includes the _search endpoint where a CapabilityStatement indicates support for the search operation.
    • Rick Geimer/Ward Weistra: 18-0-0
    • Correction
    • Non-substantive
    • R5

    Description

      To me, the core specification is pretty clear that this is required.
      From http://hl7.org/fhir/http.html#search :

      Because of the way that some user agents and proxies treat GET and POST requests, in addition to the get based search method above, servers that support search SHALL also support a POST based search

      However, the IG Publisher tooling that generates Swagger/OpenAPI definitions from a given implementation guide does not include these special POST endpoints.

      Further, when I asked about it at https://chat.fhir.org/#narrow/stream/179166-implementers/topic/Search.20via.20POST , one of the US Core authors responded to indicate that Search via POST is not required by US Core and so I think we need some clarification.

      Can IGs make these decisions for themselves or must all FHIR servers that support search also support search via POST?

      FWIW, my recommendation is this:

      • all servers supporting search SHALL support search via both GET and POST as already indicated in the base spec
      • the OpenAPI generator included with the IG Publisher tooling should be updated to include the `_search` endpoints for each searchable resource type in each IG

      Attachments

        Activity

          People

            Unassigned Unassigned
            lmsurprenant Lee Surprenant
            Watchers:
            4 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: