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.
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
Du behöver gå mot adressen https://www.1177.se/api/ med en ny API-nyckel för att kunna ansluta till nya API:et då nya 1177.se är lanserad behöver man
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://www.1177.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://www.1177.se/api/ext/">2019-01-16T16:30:31Z</lastsaved>
- Alla artiklarna har nya id, t.ex.
<id>urn:uuid:966e1c02-366c-46f0-8ef2-d05718d62190</id>
eller
<link rel="self" type="application/atom+xml" href="https://www.1177.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