Kuittauksen 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.

HTTP-vastauksen header-esimerkki

HTTP/1.1 200 
x-request-id: f3a7c9e2-8b1d-4c6f-9d3a-2e6f5b4a9c1e
content-type: application/fhir+json;charset=UTF-8
transfer-encoding: chunked
date: Fri, 10 Oct 2025 11:53:04 GMT

HTTP-vastauksen body

Kysely- ja välityspalvelu palauttaa $complete-communication -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 kuittauksen vastaussanomasta

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

Vastaussanoma virhetilanteessa

Virhetilanteissa vastauksena palautuu HTTP-virhestatuskoodi sekä HTTP-bodyssa OperationOutcome resurssi-instanssi, jolla ilmaistaan tarkempi virhe.

Vastaussanoma virhetilanteessa-sivulla on kuvattu tarkemmin, miten Kysely- ja välityspalvelu palauttaa virheilmoitukset OperationOutcome-resurssilla.