Introduction

Introduction

The mailbox (í. Pósthólfið) is a closed area on Ísland.is. It contains and stores documents from the public sector (Document providers) to individuals and companies. Individuals and companies with an Icelandic ID number have their own mailbox.

Communication between the mailbox and the document provider is through a REST API. Document providers register a reference to new documents for publication on Island.is (also referred as index or documentIndex). The documents themselves are stored by the document provider they originate from. Users can identify themselves on Island.is and see a list of documents which belong to them. If the user retrieves a document the mailbox retrieves the document from the document provider. In other words, the document is only retrieved on user request.

Document providers need to implement the Skjalaveita API which the mailbox has access to. The service needs to be created according to the pre-defined interface. The mailbox will be able to make a homogeneous query on any document provider where the endpoint different for each document provider.

Overview

Access Tokens are issued by the same idP for Skjalatilkynning API and Skjalabirting API (i.e., same idP for both directions).