Välityspyynnön vastaus

HTTP vastauksen tiedot palautetaan HTTP header- ja body-osuuksiin jaettuna. Tällä sivulla kuvataan nämä osuudet tarkemmin.

HTTP-vastauksen header

HTTP-vastauksen header-tiedot on kuvattu Kanta-palvelujen yhteisessä FHIR- ja REST-soveltamisoppaassa sivulla Kanta HTTP header-tiedot FHIR-rajapinnassa.

Huomaa, että Kysely- ja välityspalvelu generoi välityspyynnölle uniikin tunnuksen tallentaessaan sen tietokantaan, ja tunnus palautuu vastaussanoman Location -headerissa.

HTTP-vastauksen header-esimerkki

Status code: 200
x-request-id: cfaafd43-9234-4501-8508-8d840fc374a0
expires: 0
cache-control: no-cache, no-store, max-age=0, must-revalidate
x-xss-protection: 0
pragma: no-cache
x-frame-options: DENY
date: Mon, 12 Aug 2024 07:31:10 GMT
vary: Origin, Access-Control-Request-Method, Access-Control-Request-Headers
x-content-type-options: nosniff
strict-transport-security: max-age=31536000 ; includeSubDomains
transfer-encoding: chunked
content-type: application/fhir+json
Location: [base]/baseR4/CommunicationRequest/afbd4b06-cd5d-4035-86b8-1b841939c844
Last-Modified: Wed Oct 01 16:30:35 EEST 2025

HTTP-vastauksen body

Kysely- ja välityspalvelu palauttaa $relay-request -operaation vastauksena OperationOutcome -resurssi-instanssin. Resurssissa on mukana sille pakollinen issue.

Issuelle asetettu severity: "information" kertoo, että kyseessä ei ole virhe vaan informatiivinen palaute.

details-elementin tietotyyppi on CodeableConcept ja se rakentuu Coding-tietotyypistä ja text-elementistä. Coding-tietotyyppiä ei käytetä onnistuneen operaation vastauksessa.

Esimerkki onnistuneen operaation vastaussanomasta

{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "information",
      "code": "informational",
      "details": {
        "text": "Pyyntö käsiteltiin onnistuneesti."
      }
    }
  ]
}

Virhetilanteessa KVP palauttaa kuvauksen Vastaussanoma virhetilanteessa mukaisen virhevastauksen.