# Kom godt i gang med Instatus API

Source: https://instatus.com/help/da/api

Alle endpoints ligger under URL'en `https://api.instatus.com`. De følger overordnet set REST-arkitekturen.

Alle forespørgsler skal være kodet som JSON med headeren `Content-Type: application/json`.

Svar fra Instatus API, inklusive fejl, er ligeledes kodet som JSON.

## Godkendelse

Forespørgsler til Instatus API skal indeholde et API-token i Authorization-headeren:

Du kan hente din API-nøgle under Brugerindstillinger → [Udviklerindstillinger](https://dashboard.instatus.com/developer)

```bash
Authorization: Bearer <API_KEY>
```

## Find dit side-ID
Du finder dit side-ID i dashboardet på denne måde:
1. Gå til dit dashboard.
2. Højreklik på dit projekt i øverste venstre hjørne for at åbne menuen.
3. Klik på **Kopiér projekt-ID**, så bliver dit side-ID kopieret til udklipsholderen.

![Side-ID](https://instatus.com/help/page_id.png)

## Fejl

Alle API-endpoints returnerer en kode og en besked i fejlsvarene.

```json
{
  "error": {
    "code": "forbidden",
    "message": "Not authorized"
  }
}
```

## Statusværdier

Mulige sidestatusser. Det er den detaljerede `status`, som det nuværende API (v2 og senere) returnerer. Det ældre `summary.json`-endpoint og [webhook-notifikationer](https://instatus.com/help/da/webhooks) bruger en forenklet form med kun `UP`, `HASISSUES` og `UNDERMAINTENANCE`.

- `UP`
- `HASISSUES`
- `ALLUNDERMAINTENANCE`
- `ALLDEGRADEDPERFORMANCE`
- `ALLPARTIALOUTAGE`
- `ALLMINOROUTAGE`
- `ALLMAJOROUTAGE`
- `SOMEUNDERMAINTENANCE`
- `SOMEDEGRADEDPERFORMANCE`
- `SOMEPARTIALOUTAGE`
- `SOMEMINOROUTAGE`
- `SOMEMAJOROUTAGE`
- `ONEUNDERMAINTENANCE`
- `ONEDEGRADEDPERFORMANCE`
- `ONEPARTIALOUTAGE`
- `ONEMINOROUTAGE`
- `ONEMAJOROUTAGE`

Mulige komponentstatusser:

- `OPERATIONAL`
- `UNDERMAINTENANCE`
- `DEGRADEDPERFORMANCE`
- `PARTIALOUTAGE`
- `MAJOROUTAGE`

Mulige hændelsesstatusser:

- `INVESTIGATING`
- `IDENTIFIED`
- `MONITORING`
- `RESOLVED`

Mulige vedligeholdelsesstatusser:

- `NOTSTARTEDYET`
- `INPROGRESS`
- `COMPLETED`

## Spring til endpoints:

- [Statussider](https://instatus.com/help/da/api/status-pages)
- [Workspaces](https://instatus.com/help/da/api/workspaces)
- [Komponenter](https://instatus.com/help/da/api/components)
- [Hændelser](https://instatus.com/help/da/api/incidents)
- [Hændelsesopdateringer](https://instatus.com/help/da/api/incident-updates)
- [Vedligeholdelser](https://instatus.com/help/da/api/maintenances)
- [Vedligeholdelsesopdateringer](https://instatus.com/help/da/api/maintenance-updates)
- [Skabeloner](https://instatus.com/help/da/api/templates)
- [Generelle meddelelser](https://instatus.com/help/da/api/generic-notices)
- [Udfald](https://instatus.com/help/da/api/outages)
- [Teammedlemmer](https://instatus.com/help/da/api/teammates)
- [Abonnenter](https://instatus.com/help/da/api/subscribers)
- [Målinger](https://instatus.com/help/da/api/metrics)
- [Brugerprofil](https://instatus.com/help/da/api/user-profile)
- [Offentlige data](https://instatus.com/help/da/api/public-data)
- [Private sider](https://instatus.com/help/da/api/private-pages)
- [Målgrupper](https://instatus.com/help/da/api/audience-groups)
- [Monitorer](https://instatus.com/help/da/api/monitors)
- [Overvågningsintegrationer](https://instatus.com/help/da/api/monitoring-integrations)
- [Routingregler](https://instatus.com/help/da/api/routing-rules)
- [Eskaleringspolitikker](https://instatus.com/help/da/api/escalation-policies)
- [Vagtplaner](https://instatus.com/help/da/api/on-call-schedules)