Hämta innehåll från Nationellt kliniskt kunskapsstöd via API
Nationellt kliniskt kunskapsstöd är en tjänst från Sveriges regioner.
Kunskapsstödet innehåller regionernas rekommendationer för utredning, behandling och klinisk uppföljning anpassade för att stödja patientmötet i primärvård.
Rekommendationerna gäller gruppnivå. De är inte bindande. Varje enskild vårdgivare ansvarar för tillämpningen av rekommendationerna utifrån enskild patient och situation.
Innehållet kan hämtas via API för integration i egna IT-system, webbplatser eller appar. Syftet är att underlätta spridning och användning i så många patientmöten som möjligt.
För att hämta och använda innehållet behöver du ansöka om en API-nyckel och följa villkoren nedan.
Villkor för användning
- Det är inte tillåtet att ändra i innehåll från Nationellt kliniskt kunskapsstöd.
- Innehåll som speglas eller hämtas till egen lagring ska uppdateras dagligen.
- Det ska tydligt framgå vem som är avsändare och ansvarig för tjänsten som visar innehåll från Nationellt kliniskt kunskapsstöd, och hur man kontaktar ansvarig.
- Det går bra att använda delar av innehållet. Det ska tydligt framgå vilket innehåll som kommer från Nationellt kliniskt kunskapsstöd.
- Det är inte tillåtet att översätta innehållet till andra språk utan godkännande.
- Användaren ansvarar för alla egna kostnader för att exempelvis hämta innehåll, integrera, uppdatera och justera för framtida förändringar.
- Användare av innehåll från Nationellt kliniskt kunskapsstöd ska vara tillgänglig för dialog och uppföljning av användning, spridning och utvecklingsbehov.
- Användare av innehåll från Nationellt kliniskt kunskapsstöd ansvarar för att hålla kontaktuppgifter för API-nyckel aktuella, meddela eventuella förändringar av användningsområde och meddela om API-nyckeln ska avslutas.
- Användare av API-nyckel förbinder sig att inte upplåta API-nyckeln till någon annan.
Användare som inte följer villkoren förlorar rätten att visa innehåll.
Så fungerar API:et
- Respektive användare lagrar innehållet lokalt.
- Innehållet uppdateras varje dag klockan 01:30 UTC via tjänsterna i API:et.
- Innehållet hämtas i form av ”dokument” som består av avsnitt och eventuella tillägg.
- Informationens struktur beskrivs i informationsspecifikationen nedan.
Mer information
Informationsspecifikation_NKK
NBR_Utdata_definition
Tillgängliga tjänster
API:et innehåller fem tjänster som beskrivs kort nedan och finns att hämta på
Swagger: https://datadistribution.kunskapsstod.se/swagger-ui.html.
För att använda tjänsterna krävs en API-nyckel.
- [../publications/documents] - listar samtliga publicerade dokument och metadata. Informationen kan användas för att få en överblick över mängden publicerade dokument och för att avgöra om ett enskilt dokument har uppdaterats.
- [../publications/organizations] - listar organisationer som äger dokument och tillägg till dokument.
API:et erbjuder några olika varianter för att hämta dokument. Ett dokument levereras med samtliga publicerade tillägg.
- [../documents] - hämtar en lista med samtliga publicerade dokument
- [../documents] - hämtar en lista med angivna dokument
- [../documents/{id}] - hämtar ett dokument med angivet id.
Support
Varje användare av API:et ansvarar själv för sina egna tekniska lösningar och rutiner för att hämta innehåll, integrera, uppdatera och justera för framtida förändringar. Vid förändringar av API:et informeras API-användarna via mejl.
Teknisk support
Uppdaterad: 5 april 2023