bolaget.io (https://bolaget.io)

Please read this

Systembolaget will remove the information about all the products from their API starting 1st of November. They have also removed the API we used for bolaget.io. This means that bolaget.io no longer can fetch new product updates and is deprecated and now also removed. https://api-portal.systembolaget.se/api-update-blog/changes-in-the-api-portal

This API has nothing to do with Systembolaget, this app consumes a large XML API from Systembolaget and transforms it into a REST JSON API. More info can be found here: http://www.systembolaget.se/api

Flowchart

Versions

Please have a look at CHANGELOG.md for more information. Otherwise this project adheres to Semantic Versioning.

All resources will be available without versioning in the url and be an alias for the latest API version.

Products

GET /products
Host: bolaget.io

• URL Params

  Optional:

  limit=[number] - Default limit is 10, max limit is 100

  offset=[number]

  ecological=[bool]

  koscher=[bool]

  ethical=[bool]

  year_from=[number]

  year_to=[number]

  sales_start_from=[date] - YYYY-MM-DD

  sales_start_to=[date] - YYYY-MM-DD

  price_from=[number]

  price_to=[integer]

  volume_from=[integer]

  volume_to=[number]

  assortment=[alphanumeric] - BS = Reservation assortment, TSE = Temporary assortment, FS = Regular assortment and FSN = Regular assortment (new product), TSLS = Locally produced

  assortment_text=[alphanumeric] - Ordervaror = BS, Fast sortiment = FS, Tillfälligt sortiment = TSE, Fast sortiment = FS/FSE, Lokalt & Småskaligt = TSLS

  sort=[alphanumeric] - Property to sort by, accepting:

  • price:asc|desc
  • price_per_liter:asc|desc
  • volume_in_milliliter:asc|desc
  • sales_start:asc|desc
  • year:asc|desc
  • zip_code:asc|desc
  • name:asc|desc
    
    

  name|type|style|provider|producer|origin|origin_country|packaging|product_group|sealing|commodities=[alphanumeric] - Fuzzy match

  search=[alphanumeric] - Fuzzy search in several fields

• Response headers:

  X-Total-Count=[number] - Total count of products based on filtering used for pagination

• Success Response:

  • Code: 200
    Content: [{ name: '117 Grythyttan' ... }] or []

• Error Response:

  • Code: 500 INTERNAL SERVER ERROR
    Content: { error : "Ouch, an ugly error has occured!" }

Product

GET /products/:nr
GET /products/:article_nr
Host: bolaget.io

• Success Response:

  • Code: 200
    Content: { nr: 12, name: "117 Grythyttan" ... }

• Error Response:

  • Code: 500 INTERNAL SERVER ERROR
    Content: { error : "Ouch, an ugly error has occured!" }

  OR

  • Code: 404 NOT FOUND
    Content: { error : "Move along, nothing to see here!" }

Stores

GET /stores
Host: bolaget.io

• URL Params

  Optional:

  limit=[number] - Default limit is 10, max limit is 100

  offset=[number]

  labels=[alphanumeric] - Takes a comma separated list, eg. norrbotten,jämtland, returns documents containing all labels matched (fuzzy)

  sort=[alphanumeric] - Property to sort by, accepting:

  • RT90x:asc|desc
  • RT90y:asc|desc
  • address:asc|desc
  • city:asc|desc
  • county:asc|desc
    
    

  type|name|city|county|address=[alphanumeric] - Fuzzy match

  search=[alphanumeric] - Fuzzy search in several fields

• Response headers:

  X-Total-Count=[number] - Total count of stores based on filtering used for pagination

• Success Response:

  • Code: 200
    Content: [{ adress_1: 'Kungsholmstorg 11 A' ... }] or []

• Error Response:

  • Code: 500 Internal Server Error
    Content: { error : "Ouch, an ugly error has occured!" }

Store

GET /stores/:nr
Host: bolaget.io

• Success Response:

  • Code: 200
    Content: { address: "Vasagatan 25", ... }

• Error Response:

  • Code: 500 INTERNAL SERVER ERROR
    Content: { error : "Ouch, an ugly error has occured!" }

  OR

  • Code: 404 NOT FOUND
    Content: { error : "Move along, nothing to see here!" }

Development environment

Kubernetes

You need a local Kubernetes cluster (minikube, docker-for-mac etc.) with helm installed.

Build:

make build

Install:

helm install \
  -f chart/values.yaml \
  -f chart/values-dev.yaml \
  --set web.image.tag=local \
  --set web.image.pullPolicy=Never \
  --name bolagetio \
  ./chart

Docker Compose

Using Docker and Docker Compose (https://www.docker.com/)

Build

• docker-compose build

Start

• docker-compose up web

Start worker

• docker-compose run --rm web npm run dev:worker

Run tests

• docker-compose run --rm web npm test