Kom i gang

Open Aidn er Aidns integrasjonsplattform for godkjente tredjepartssystemer som skal utveksle helsedata med Aidn på vegne av en kommune.

API-ene er basert på HL7 FHIR R4, med OAuth 2.0 for tilgangsstyring og scopes inspirert av SMART on FHIR. Hver integrasjon aktiveres for en kommune og får bare scopes og datatilgang som trengs for det godkjente bruksområdet.

Dokumentasjonsstruktur

Dokumentasjonen er delt i tre deler:

Generelt integrasjonsoppsett forklarer autentisering, tilgang, etterlevelse og hvordan kommuner aktiverer integrasjoner.
FHIR API-referanse forklarer FHIR-ressurser, endepunkter, støttede søkeparametre og responsfelter som er tilgjengelige gjennom Open Aidn.
Bruksområder beskriver konkrete integrasjonsscenarier og lenker tilbake til generelt oppsett og API-referanse.

Typisk oppstartsflyt

flowchart TD
    A[Avklar integrasjonens omfang] --> B[Kommunen aktiverer integrasjonen]
    B --> C[Opprett OAuth-klient]
    C --> D[Registrer offentlig nøkkel og scopes]
    D --> E[Leverandøren henter access token]
    E --> F[Leverandøren kaller Open Aidn FHIR API-er]
    F --> G[Overvåk tilgang og roter nøkler]

Hva du trenger før du kaller et API

Et avtalt bruksområde og datagrunnlag med kommunen og Aidn.
Open Aidn base URL for aktuelt miljø.
Client ID og registrert offentlig nøkkel for OAuth-klienten.
Privatnøkkelen som hører til den registrerte offentlige nøkkelen, lagret sikkert i leverandørens system.
FHIR scopes som kreves av API-endepunktene du skal bruke.
Kommunespesifikke konfigurasjonsverdier, for eksempel avdelings-ID-er for lokasjonsbaserte integrasjoner.

Start med Autentisering og tilgang, og les deretter API-referansen og bruksområdeguiden for integrasjonen.

Back to the homepage