Att ta fram NMI-ID via API
Här kan du ta del av hur du som använder våra NMI-klassade produkter som finns beskrivna i Handboken går tillväga för att ta fram NMI-ID via API.
1. Inledning
Den Nationella Läkemedelslistan tillhandahåller ett flertal API:er för integration med vård- och apotekssystem. I versionspaket 21 är API:et baserat på FHIR (http://hl7.org/fhir/R4/) och det är detta API som används för att ta fram NMI-ID:t.
FHIR bygger på HTTP-baserad kommunikation. Alla HTTP-anrop och HTTP-svar innehåller ett sidhuvud med metadata, sk. headers. Alla anrop initieras från det system som ansluter till den Nationella Läkemedelslistan och i HTTP-svaret medföljer NMI-märkningen för det API som har anropats.
2. HTTP-svar
Exempel på HTTP-svar där anrop har skett till ett NMI-klassificerat system.
HTTP-svar
NMI-ID: EHM-AT21-v6,EHM-VT21-v6 Content-Type: application/fhir+xml;charset=utf-8 X-Request-ID: eaea5c49-545a-4958-89c2-bf0baae0b15e
Fältet NMI-ID innehåller ett eller flera NMI-id:n om det är ett NMI-klassificerat system.
3. CapabilityStatement
För API:er baserade på FHIR är det även möjligt att utläsa NMI-märkningen genom att hämta det som i FHIR kallas ett CapabilityStatement. Se http://hl7.org/fhir/R4/http.html för mer information om kommunikation i FHIR.
Exempel på svar från en FHIR-server.
CapabilityStatement
{ "resourceType": "CapabilityStatement", "id": "d545e2ff-593f-400d-9cb0-4bb00ee9e3d9", "name": "RestServer", "status": "active", "date": "2023-02-23T13:53:00.203+01:00", "publisher": "E-hälsomyndigheten", "description": "Nationella Läkemedelslistan NMI-ID: EHM-AT21-v6 och EHM-VT21-v6.", "kind": "instance", "software": { "name": "HAPI FHIR Server", "version": "5.6.2" }, ... }
Fältet description innehåller texten "NMI-ID:" följt av ett eller flera NMI-id:n om det är ett NMI-klassificerat system.
4. NMI-produkter
Mer information om de NMI-produkter som beskrivs i Handbok för vård- och apotekstjänster finns här.
Versionshistorik
Version | Datum | Release | Kommentar |
---|---|---|---|
1.0 | 2023-05-04 | 21.5 | Ny sida |