Systembevakningsagenten

Bevakar ölsläppen på Systembolaget


API

Om vårt API

Här hittar du mer information om hur du använder vårt JSON-API. Vi kan inte garantera att API:et alltid fungerar och är korrekt, då det som agenten i övrigt bygger på data från Systembolaget.

Vi rekommenderar att du använder vårt JSON-API när du utvecklar mobila appar eller vill inkludera delmängder av data på en annan webbplats. Det finns ett antal olika tjänster, de stödjer alla JSONP med callback-parameter.

När vi gör förändringar i API:et publiceras en helt ny version som anges i sökvägen, t ex 1.0 för första versionen och 1.0.1 för en uppdaterad. På så sätt bör äldre klienter fortsätta fungera, men det är ingen garanti.

newProducts.json

Returnerar endast produkter i det senaste, aktiva nyhetssläppet.

newProducts.json (2.0)

Returnerar produkter i de åtta senaste eller kommande släpp som vi känner till, räknat baklänges på releasedatum.

firstSaleList.json (2.0)

Lista över släppdatum och hur många produkter som initialt och idag finns för varje datum.

coverageList.json

Täckningskarta för produkterna i senaste släppet.

inventoryForProduct.json

Lagersaldon för en viss produkt, som specificeras med parameter "id". Förutom saldon visas grunddata om produkten.

inventoryForStore.json

Lagersaldon för en viss butik, som specificeras med parameter "id". Förutom saldon visas grunddata om butiken.

historyForProduct.json (2.1)

Historik för en viss produkt, som specificeras med parameter "id". Visar i vilka butiker som produkten har funnits och när senaste lagersaldot registrerades. Kan ta några sekunder att ladda.

historyForStore.json (2.1)

Historik för en viss butik, som specificeras med parameter "id". Visar vilka produkter som har lagerförts i butiken och när senaste lagersaldot registrerades. Kan ta några sekunder att ladda.

searchProduct.json (2.1)

Huvudingång för sökning på produkter. Parametern "query" beskriver sökfrågan. Parametern "all" ska vara true om du även vill söka bland historiska produkter som ej bevakas längre. Med version 2.1 använder vi PostgreSQL fulltextsök och inte längre Solr.

searchStore.json (2.1)

Sökning på butiker. Sökfrågan i parametern "query". Parametern "all" ska vara true om du vill söka bland inaktiva butiker. Från version 2.1 använder vi PostgreSQL fulltextsök och inte längre Solr.

searchStore.json (GPS-koordinater, 2.1)

Sökning på butiker efter geografisk placering. Parametrarna "lat" och "lng" skickas in med koordinaterna där användaren befinner sig. Parametern "dist_km" anger inom vilken radie sökning ska göras och är förvalt 3 km. Resultatet sorteras alltid på avståndet i km.

getActiveStores.json (2.1)

Alla aktiva butiker som bevakas för tillfället. Listan innehåller även datumstämplar för när butiken senast kollades och uppdaterades.

12 april 2021, 1 st
3 maj 2021, 155 st (säljstart om 21 dagar)
27 april 2021, 6 st (säljstart om 15 dagar)
23 april 2021, 3 st (säljstart om 11 dagar)
20 april 2021, 11 st (säljstart om 8 dagar)
13 april 2021, 14 st (säljstart imorgon)
7 april 2021, 13 st
6 april 2021, 168 st
23 mars 2021, 11 st
16 mars 2021, 12 st
15 mars 2021, 73 st
11 mars 2021, 5 st
9 mars 2021, 14 st
2 mars 2021, 15 st
1 mars 2021, 151 st