Kom i gang

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

API-ene bygger på HL7 FHIR R4 og bruker OAuth 2.0 for tilgangsstyring. Tilgangene er inspirert av SMART on FHIR. Hver integrasjon aktiveres for en kommune og får bare tilgang til dataene som trengs for det godkjente bruksområdet.

Dokumentasjonsstruktur

Dokumentasjonen er delt i tre deler:

1. Generelt integrasjonsoppsett forklarer autentisering, tilgangsstyring, etterlevelse og hvordan kommuner aktiverer integrasjoner.
2. FHIR API-referanse beskriver FHIR-ressursene, endepunktene, de støttede søkeparametrene og responsfeltene i Open Aidn.
3. Bruksområdeguider beskriver konkrete integrasjonsscenarioer og viser videre til det generelle oppsettet og API-referansen.

Typisk oppstart

flowchart TD
    A[Avklar integrasjonens omfang] --> B[Opprett OAuth-klient]
    B --> C[Registrer offentlig nøkkel og tilganger]
    C --> D[Kommunen aktiverer integrasjonen]
    D --> E[Leverandøren henter tilgangstoken]
    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.
• Baseadressen til Open Aidn for det aktuelle miljøet.
• Klient-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.
• Tilgangene som kreves av FHIR-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 guiden for bruksområdet ditt.