Todistuksen haku asiointipalveluun henkilötunnuksen perusteella

Sosiaali- ja terveydenhuollon ulkopuolisen toimijan asiointipalvelu voi tehdä yhdistetyn haku- ja välityspyynnön. Voit lukea tästä lisää käyttötapauksesta: Todistuksen haku asiointipalveluun henkilötunnuksen perusteella .

Välityspyynnön HTTP pyyntö (request)

Yhidstetty haku- ja välityspyyntö lähetetään kysely- ja välityspalvelulle HTTP POST-pyyntönä operaatiolla $get-persons-documents. Operaation pyynnössä ilmoitetaan välitystä pyytävän henkilön henkilötunnus, todistuksen näkymäkoodi ja todistuksen luontihetken aikaväli.

Rajapinnan OperationDefinition-kuvaus

Invocations

URL: [base]/$get-persons-documents

This operation does NOT change content

Parameters (In)

Name	Cardinality	Type	Binding	Documentation
patient	1..1	CodeSystem	urn:oid:1.2.246.21 (required)	Henkilö jonka todistuksia haetaan. Muoto: henkilötunnus.
viewCode	1..1	CodeSystem	urn:oid:1.2.246.537.6.12 (required)	Todistuksen tyyppi
startDate	0..1	date		Todistuksen luontiajan alkupäivä
endDate	0..1	date		Todistuksen luontiajan loppupäivä
reload	0..1	boolean		Palauta uudelleen jo haetut mutta kuittaamattomat todistukset

Return Values (Out)

Name	Cardinality	Type	Documentation
results	1..1	Bundle	The bundle type is "searchset"

Sekvenssikaavio

HTTP pyynnön header

HTTP-pyynnön header-tiedot on kuvattu Kanta-palvelujen yhteisessä FHIR- ja REST-soveltamisoppaassa. Voit lukea lisää oppaan sivulla Kanta HTTP header-tiedot FHIR-rajapinnassa

Kannattaa kuitenkin huomioida erityisesti headerin kenttä X-Request-Id, jonka arvo on oltava yksilöllinen jokaiselle http-pyynnölle.

Pyynnön HTTP header esimerkki

POST [base][api] HTTP/1.1 
Accept: application/fhir+json
Authorization: Bearer eyJraWQiOiJyc2ExIiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiJhMTcxYjFmNC04ZDkwLT...
X-Request-Id: 1.2.246.10.1.20241208102307.93.2023.11023072024880604629
Content-Type: application/x-www-form-urlencoded

HTTP pyynnön body

Operaation parametrit välitetään HTTP pyynnön body-osuudessa Parameters-resurssin avulla. Voit lukea lisää Parameters-resurssista FHIR-standardista.

Hakupyynnön esimerkki

{
    "resourceType": "Parameters",
    "parameter":  [
        {
            "name": "patient",
            "valueString": "urn:oid:1.2.246.21|030559-914N"
        },
        {
            "name": "viewCode",
            "valueString": "urn:oid:1.2.246.537.6.12.2002|151"
        },
        {
            "name": "startDate",
            "valueString": "1900-01-01"
        },
        {
            "name": "endDate",
            "valueString": "2025-04-15"
        },
        {
            "name": "reload",
            "valueString": "true"
        }
    ]
}

Vastaussanoma virhetilanteessa

Virhetilanteissa vastauksena palautuu HTTP virhestatuskoodi sekä HTTP bodyssa OperationOutcome resurssi-instanssi, jolla ilmaistaan tarkempi virhe. KVP:n Käyttämää OperationOutcome-resurssia ei ole profiloitu.

OperationOutcome-sivulla on kuvattu tarkemmin, miten KVP palauttaa virheilmoitukset OperationOutcome-resussilla.