On this page:
   28.37    FHIR Resource Types 28.39    FHIR Search   

28.38FHIR REST Endpoint

 

The FHIR REST Endpoint configuration category includes the following configurable options:

  • Fixed Value for Endpoint Base URL

  • Pretty-Print by Default

  • Default Encoding

  • Default Prefer Return

  • Serve Raw Media Resources

  • Process Header: Request Source

28.38.1Property: Fixed Value for Endpoint Base URL

 
Property Name Fixed Value for Endpoint Base URL
Property Key
Property Type STRING
Description If specified, the server will always use this base URL for FHIR responses (e.g. in Location headers, Bundle paging links, etc.). Note that changing this setting does not actually change the port or address that Smile CDR will use to serve up this endpoint. This setting merely changes the URL that will be advertised in responses.
Default Value (no default)
Example Property
module.[MODULE_ID].config.base_url.fixed = 

28.38.2Property: Pretty-Print by Default

 
Property Name Pretty-Print by Default
Property Key
Property Type BOOLEAN
Description If enabled, responses will be pretty-printed by default unless the client request explicitly requests non-pretty-printed responses. Pretty-printed responses are useful for debugging and human readability but they contain extra spaces to they can have performance and size impacts.
Default Value true
Example Property
module.[MODULE_ID].config.default_pretty_print = true

28.38.3Property: Default Encoding

 
Property Name Default Encoding
Property Key
Property Type ENUM
Values
  • JSON
  • XML
  • RDF
Description Specifies the default encoding (i.e. JSON/XML) to use if the client does not specify a preference in the request.
Default Value JSON
Example Property
module.[MODULE_ID].config.default_encoding = JSON

28.38.4Property: Default Prefer Return

 
Property Name Default Prefer Return
Property Key
Property Type ENUM
Values
  • REPRESENTATION
  • MINIMAL
  • OPERATION_OUTCOME
Description This setting controls the default HTTP response payload for FHIR create/update/patch/transaction operations. By default the body of the resource as it was stored is returned (REPRESENTATION), but this default behavior can be changed to return an OperationOutcome resource (OPERATION_OUTCOME) or no payload at all (MINIMAL) by modifying this setting. Note that clients may override the default behavior on individual requests using the HTTP Prefer header as described in the FHIR Specification.
Default Value REPRESENTATION
Example Property
module.[MODULE_ID].config.default_prefer_return = REPRESENTATION

28.38.5Property: Serve Raw Media Resources

 
Property Name Serve Raw Media Resources
Property Key
Property Type BOOLEAN
Description If enabled, clients may request a FHIR Read on a Media resource using either an Accept header or an additional parameter that requests the raw contents of the resource be served directly instead of the complete FHIR resource. See Serving Raw Media Resources for more information.
Default Value false
Example Property
module.[MODULE_ID].config.serve_raw_media_resource = false

28.38.6Property: Process Header: Request Source

 
Property Name Process Header: Request Source
Property Key
Property Type BOOLEAN
Description If enabled, the server will respect the X-Request-Source header. See Capturing Source Information for more details.
Default Value false
Example Property
module.[MODULE_ID].config.process_request_header.request_source_enabled = false
   28.37    FHIR Resource Types 28.39    FHIR Search