Synkron integrasjon fra Helsenorge til aktør

• REST-kall til endepunkt hos aktør

  • Benyttes alltid HTTPS (ikke krav om toveis-SSL)

  • HTTP verb:

    • HTTP GET ved status forespørsel (ingen body)

    • HTTP POST ved selvbetjeningsfunksjoner (som har body)

  • Alltid bruk av JWT token i REST-kall. Dette skal “forstås- og valideres av aktør: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/726302764

    • Innbyggers fødselsnummer som det spørres om status for skal hentes fra JWT

Status for deltakere i forskning og screening og Interaksjon med deltakere i forskning og screening

• Kall: 

  • URL som er konfigurert på Helsenorge peker til metode i endepunkt hos aktør som gir denne funksjonaliteten. Ingen parametere, kun JWT-token i HTTP-header.

• Respons:

  • HTTP-respons kode

  • Payload:

    • Status-rapport_v1.0.xsd (se skjemaer nederst på siden)

      • Inkludert skjema: Innsyn-felles-v1.0.xsd

      • Kan inneholde selvbetjeningsfunksjoner:

        • Kall når selvbetjeningsfunksjon utføres på Helsenorge: 

          • URL som er konfigurert på Helsenorge knyttet til referert selvbetjeningsfunksjon. Peker til metode i endepunkt hos aktør som gir denne funksjonaliteten. JWT-token i HTTP-header.

          • Når innbygger utfører en selvbetjeningsfunksjon skal det våre følgende i Payload:

            • For EnkleFunksjoner skal det alltid være med følgende i Body fra Helsenorge: 

            {
              "funksjonKortnavn":"<kortnavnet på funksjonen>"

              "funksjonsType":1

               "nyTilstand": true eller false
            }

            • For RadioFunksjoner skal alltid følgende med i Body

            {
               "funksjonKortnavn":"<kortnavnet på funksjonen>"

               "funksjonsType":2

               "valgtOpsjon":"<Opsjonkortnavn>"
            }

               

        • Respons: Kun HTTP-respons kode

Informasjon om at innbygger er inkludert i forskningsprosjekt eller screeningprogram

For at et forskningsprosjekt eller screeningprogram skal vises for innbygger er det en forutsetning at det er sendt en såkalt “inkluderingsbillett” for den aktuelle innbygger til Personvernkomponenten (PVK).

Her tilbys det både:

• Synkront grensesnitt fra aktør mot PVK: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/636780545

• Og inkluderingsbillett via meldingsformidling (AMQP): https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1471447152

For generell informasjon om PVK og hvordan et forskningsprosjekt eller screeningprogram kan benytte denne for å administrere samtykker g reservasjoner se her:

XML-skjemaer

Skjema for statusrespons:

Open

Inkludert skjema med felleskomponenter benyttet for innsyn:

Open

Status Rapport

Open

Selvbetjeningsfunksjoner (fra skjema Innsyn-felles)

Open

Footer med dyplenke (fra skjema Innsyn-felles)