1177 VÅRDGUIDEN PÅ WEBBEN

Anslutning till tjänsten för 1177 Vårdguidens API är tillfälligt stängd

Tjänsten beräknas öppna senare i år och då finns det åter möjlighet att ansöka om en nyckel. Du är välkommen att skicka in en intresseanmälan så kontaktar vi dig när tjänsten öppnar.

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.

Intresseanmälan för en API-nyckel

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

  1. Nyckeln skall heta: Authorization
  2. 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.

  1. Summary är av typen text och inte html, t.ex.

    <summary type="text">Ingress på sidan</summary>

  2. Kategorierna för sidorna kan vara nya och ändrade, t.ex.

    <category term="Liv &amp; hälsa" />

<category term="Reseråd och vaccinationer" />

  1. Artiklarna har numera olika informationstyper, dessa exponeras via egenskapen informationtype, t.ex.

    <informationtype xmlns="https://1177.nogui.se/api/ext/">Artikel</informationtype>

  2. 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>

  1. 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/" />

 

  1. 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">&lt;div id="react_0HLJT4986UN8T"&gt;&lt;div data-reactroot=""&gt;&lt;div&gt;&lt;div class="c-chapter-container"&gt;&lt;h2&gt;Reseråd&lt;/h2&gt;&lt;div&gt;&lt;div class="c-chapter"&gt;&lt;div&gt;&lt;h3&gt;R&amp;aring;d om mat&amp;nbsp;&lt;/h3&gt;

&lt;div class="section body-text"&gt;

&lt;p&gt;Det finns ett par r&amp;aring;d om mat och dryck som du kan f&amp;ouml;lja f&amp;ouml;r att f&amp;ouml;rs&amp;ouml;ka minska risken att f&amp;aring; turistdiarr&amp;eacute; p&amp;aring; resan. Men eftersom smitt&amp;auml;mnena som orsakar diarr&amp;eacute; &amp;auml;r vanliga &amp;auml;r det inte l&amp;auml;tt att undvika besv&amp;auml;r.&lt;/p&gt;</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
Till toppen av sidan