Anslutning till tjänsten för 1177 Vårdguidens API
Möjligheten att ansöka om API-nyckel för att spegla innehåll från 1177.se erbjuds i nuläget enbart till regioner. Tjänsten beräknas att öppna för andra aktörer under 2020.
API är en teknisk tjänst som kan användas för att utveckla egna tillämpningar med innehåll från 1177.se. Genom ett standardbaserat gränssnitt får du tillgång till artiklar i olika innehållskategorier. Tjänsten möjliggör att du kan spegla texter från 1177 Vårdguiden till dina egna plattformar.
Med hjälp av en teknisk nyckel implementerar du API-lösningen i ditt system och kan i egna kanaler spegla våra texter som vi producerar och uppdaterar. Det ger dina användare relevant och aktuell kunskap inom hälsa och vård.
Instruktion för att använda nya API:et för syndikering för 1177.se
För att kunna ansluta till nya API´et då nya 1177.se är lanserad behöver man gå mot adressen https://www.1177.se/api/ med en ny API-nyckel.
Anslutning
För att kunna använda API:et behöver man numera skicka med nyckeln i headern på requestet och inte i query-strängen. Läs mera här https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Authorization
- Nyckeln skall heta: Authorization
- Värdet på nyckeln skall vara:
“ApiKey nyckelvärde”, exempel
”ApiKey 3c7cee9c-a184-47aa-b06a-d895b7377920”
Om man inte skickar med nyckeln eller har fel nyckel så får man felmeddelande att man inte är behörig (error code 401).
Alla artiklar/Fullhämtning
Anropet till API’et är https://www.1177.se/api/artiklar för att hämta ut alla artiklarna.
Specifik artikel
Man kan även hämta ut enskilda artiklar med sid id, till exempel https://www.1177.se/api/artiklar/45186
Regionaliserade artiklar
Man kan även hämta ut artiklar som är regionaliserade, till exempel https://www.1177.se/api/kronoberg/artiklar/
Format
Formatet på information är nästan likadant som tidigare men det finns några undantag då 1177.se är omskriven helt och hållit från början.
- Summary är av typen text och inte html, t.ex.
<summary type="text">Ingress på sidan</summary> - Kategorierna för sidorna kan vara nya och ändrade, t.ex.
<category term="Liv & hälsa" />
<category term="Reseråd och vaccinationer" />
- Artiklarna har numera olika informationstyper, dessa exponeras via egenskapen informationtype, t.ex.
<informationtype xmlns="https://1177.nogui.se/api/ext/">Artikel</informationtype> - Datumfält har nytt format, t.ex.
<published>2019-01-16T14:39:09Z</published>
<updated>2019-01-16T16:30:31Z</updated>
<lastsaved xmlns="https://1177.nogui.se/api/ext/">2019-01-16T16:30:31Z</lastsaved>
- Alla artiklarna har nya id’en, t.ex.
<id>urn:uuid:966e1c02-366c-46f0-8ef2-d05718d62190</id>
eller
<link rel="self" type="application/atom+xml" href="https://1177.nogui.se/api/artiklar/46326/" />
- Innehållet i artikeln kommer i noden
<content type="html">Sidans html text</content>
Eftersom den nya webbplatsen är omskriven och använder ett helt nytt ramverk och design så är det nya div-taggar och klasser på alla objekten. Innehållet är också HTML-encodat.
Ett exempel kan se ut så här:
<content type="html"><div id="react_0HLJT4986UN8T"><div data-reactroot=""><div><div class="c-chapter-container"><h2>Reseråd</h2><div><div class="c-chapter"><div><h3>R&aring;d om mat&nbsp;</h3>
<div class="section body-text">
<p>Det finns ett par r&aring;d om mat och dryck som du kan f&ouml;lja f&ouml;r att f&ouml;rs&ouml;ka minska risken att f&aring; turistdiarr&eacute; p&aring; resan. Men eftersom smitt&auml;mnena som orsakar diarr&eacute; &auml;r vanliga &auml;r det inte l&auml;tt att undvika besv&auml;r.</p></content>
Övrigt
- Bilder och videoblock tvättas bort vid anropet till API’et.
- Vid felaktiga in parametrar returneras 400 Bad Request
- Publechid utgår
- Category, vi använder enbart kategorier som är satta på sidan