# Pósthólfið

## Getting started

* Request access to the mailbox (í. Pósthólfið). You can apply for access to the mailbox at island.is' application site <https://island.is/postholf/stofnanir.\\>
  The application has to include information about the institution that is applying as well as information about the guarantor (í. ábyrgðaraðili) and technical point of contact.
* If the application is accepted, the technical point of contact will receive the following information:
  * ClientId / ClientSecret - To be able to use the Skjalatilkynning API
  * Audience
  * Scope
* The applicant needs to implement an executable that delivers document references to the mailbox by calling [Skjalatilkynning API](https://github.com/island-is/island.is/blob/main/handbook/technical-overview/postholf/postholf-03-interface-skjalatilkynning.md). An example can be seen in the Keyrsla section in the following link: <https://github.com/digitaliceland/postholf-demo>
* The applicant has to implement a callback service that returns a document when it's requested by the user. The service has to be implemented according to the [Skjalaveita API interface](/products/postholf/postholf-03-interface-skjalaveita.md). Example: <https://github.com/digitaliceland/postholf-demo>
* Information must be sent to Stafrænt Ísland regarding where (url) to call the aforementioned service.

## Content

* [Security Checklist](/products/postholf/postholf-00-security-checklist.md)
* [Introduction](/products/postholf/postholf-01-intro-and-overview.md)
* [Skjalatilkynning API](/products/postholf/postholf-02-interface-skjalatilkynning.md)
* [Skjalaveita API](/products/postholf/postholf-03-interface-skjalaveita.md)
* [Sequence Diagram](/products/postholf/postholf-04-sequence-diagram.md)
* [Interfaces](/products/postholf/postholf-05-interfaces.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.devland.is/products/postholf.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.