Hej, jag heter Jeroen de Munter utredare på Socialstyrelsen.
Idag ska vi prata om WHOs övergång till den nya digitala
klassifikationen ICD-11.
I den här presentationen ska vi ha fokus på vilka möjligheter
som finns med ICD-API.
ICD-API är ett av verktygen som finns på WHOs webbsida.
Ni kan läsa mer på deras landningssida för ICD-11.
Man kan söka sig till det genom att söka på ICD-11 och WHO eller
skriva in deras adress http//icd.vho.int.
Kommer man till sidan då ser man på vänster spalten en lista
med verktyg.
Den tredje verktygen från toppen där heter ICD-API.
Jag har markerat det här med en röd cirkel. Klickar man på den.
Då kommer man på deras specifika ICD-API-sida.
Men först vill jag berätta lite mer vad vi ska göra.
Vi vill gärna förstå möjligheter som finns i ICD-API.
Vi vill veta vad är WHOs API -specifikation.
Syftet med det här är att...
kunna utnyttja den utveckling och de möjligheter som finns och
göra en smidig övergång till ICD-11 på bäst möjliga sätt.
Vi ska kolla på deras API -dokumentation, så kallade
Swagger-sida och vi ska registrera ett konto för att
kunna skicka API-frågor.
I den här presentationen kommer jag att visa hur man kan skicka
API-frågor för att få en kapitellista.
Hur man kan få information från en URI, Autocode och Describe.
Det finns många fler frågor man kan skicka.
Det får man utforska själv.
Har man klickat på ICD-API på ICD-11 landningssidan kommer man
på den här ICD-API-sidan.
På vänstra sida ser ni lite information om hur man kan
använda ICD-API.
Det finns API-dokumentation och det finns en Swagger-sida med
deras API-specifikation.
Först kan man registrera ett konto för att kunna skicka frågor.
Har man loggat in då får man tillgång till så kallade API-nycklar.
De kan man hitta på mittenspalt.
Nu har jag loggat in och som ni ser finns det nu en länk som...
möjliggör då att man kan ta del av sina API-nycklar.
De ligger under klient ID och klient Secret.
Om de inte finns kan man alltid skapa nya klient-nycklar genom
att klicka på Add a new client.
Nu ska man logga in på Swagger -sidan med dina klient-ID och
Klient Secret-nycklar.
Det enklaste är att klippa eller att klistra.
Kopiera och klistra dina nycklar till någon annan anteckningsapp
eller så. Så att man kan lätt fylla i dem.
Via den här skärmen kommer man då till Swagger-sidan.
Den ser ut så här.
På den gröna knappen till höger som heter Autorize kan man logga in.
Och det är just där man fyller i sina klient-id och klient
-secretnycklar.
För mig ser det ut så här.
I en tidigare version behövde man inte bocka i ICD-API-access
men nu måste man bocka i det.
Jag har inte markerat det på bilden men bocka gärna i
checkboxen och klick sedan på authorize.
När man har loggat in och det ser bra ut så ser det ut så här
trycker man på close och stängs fönstret.
Nu ska vi börja skicka API-frågor och första frågan är att vi vill
gärna få kapitel-listan från ICD-11.
Kollar man på swagger-sidan och scrollar lite längre ner, då
ligger under Linearization- rubriken på andra raden en
specifikation för hur man kan få ut kapitel-listan.
Den så kallade endpunkten ser ut så här, jag har markerat den
med en röd cirkel.
Man kan läsa lite mer beskrivning på engelska vad
endpunkten kan ge för information.
Man trycker på pilen här för att fälla ner rutan.
Och sen kan man klicka på knappen Try it out för att börja
fylla i och sammanställa sin fråga.
Just den här endpunkten behöver information om fyra parametrar.
Linearization name, release ID, API-version och
Accept Language.
Jag har fyllt i dem så här.
MMS-2025-01.
Api version V2.
Och vi vill ha svar på svenska.
Det anger man genom att fylla i SV.
Sen trycker man på Execute -knappen.
Det är lite kryptisk svar man får.
Det är ju egentligen tänkt för maskin till maskin.
Men på det här sättet kan man ändå se vad som händer.
Och det är strukturerat text som skickas fram och tillbaka.
Det är möjligt för oss att förstå.
Man måste kanske anstränga sig lite grann.
Men man ser i alla fall vilken information man kan få utav just
den här endpunkten.
Kollar man lite ner då ser man server response.
Och vilken information som skickades tillbaka.
Man ser... här till exempel att det finns en block med information som
heter Child.
Och eftersom ICD är en hierarkisk struktur finns det
många objekt under den här informationsmängden som heter Child
Och den första avslutar med en URI som man kanske känner igen.
Det är första kapitlet i ICD-11.
Den slutar på de tre sista siffrorna, 666.
Jag har gjort dem lite större.
Går man då tillbaka till söktjänsten och kollar på första
kapitlet, då ser man just i URI:n på webbsidan att det var
den URI:n som vi fick via API tillbaka.
Hur är det då om vi vill ha information från en URI?
Det finns en endpunkt för det, för det är med.
Läser man lite längre ner på femte blocket här.
Det finns en endpunkt för att få information just om vad som
finns sparat under en URI.
Vi kan skicka en fråga och testa själv genom att trycka på
knappen Try it out.
Jag är intresserad i diagnosen typ 2 diabetes mellitus.
I söktjänsten har jag kopierat själva URI-koden som jag behöver
för att fylla i endpunkt.
I stort sett är det precis lika information man måste fylla i
som tidigare.
Så för Linearization Name har jag angett MMS och Release ID
2025-01.
Fast den nya endpunkten vill också information om vilket id
man vill information om.
Där har jag fyllt i URI:n
API version V2 och Accept Language svenska.
Sen trycker jag på knappen Execute.
Och man får samma resultat tillbaka fast med lite olika
information som tidigare.
Till exempel ser man här vilken kod URI:n avser, vilken class det
ligger under den som kallas kategori och vilka möjligheter
till postkoordination det finns.
Man ser till exempel också här att det finns möjlighet för att
kunna kolla om postkoordination är obligatorisk eller om man får
fylla i flera olika värden där.
Det är något som inte finns tillgängligt i söktjänsten men
man ser i API att det ligger sparat.
Nästa exempel är hur man kan använda Autocode.
Autocode är en endpunkt där man kan skicka en text och API:n ger
tillbaka då svar om vad koden innehåller för diagnoser.
Vi ska testa.
Här har jag till exempel sökt på typ 2 diabetes med katarakt.
I övrigt följer jag i precis samma information som tidigare.
Trycker jag på Execute.
Då ser man resultatet från API:n.
Min söktext resulterar i att API:n kommer med ett kod-
förslag tillbaka.
Och vilken matchningsscore det får.
Ett sista exempel är hur Describe fungerar.
Describe är en endpunkt som ger information om ett kodkluster.
Nu ska vi testa.
Jag fyller i en jättestor ICD-11-kod.
På det här sättet.
I svaret som kommer tillbaka ser man tydligt vilken kod man
har skickat.
Och vad koden står för.
Man kan hitta till exempel olika tecken och strukturen i
koden för att underlätta läsbarheten.
Man kan även säga vilken post- koordinationskoder som har använts.
Ja, det var bara ett axblock av möjligheterna i WHOs ICD-API.
Du får gärna utforska själv.
Vad har vi gjort?
Vi har kollat på nya tekniska möjligheter med ICD-API.
Vi har utforskat WHOs ICD-API -specifikation och skickat egna
API-frågor via deras Swagger- interface.
Har du frågor om klassifikationer och koder kan
du få information via Socialstyrelsens webbsida.
Det finns även mer information om ICD-11.
Tack så mycket och lycka till!
Undertexterna är AI-genererade och granskade av expert.