# Kom i gang med Instatus API

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

Alle endepunkter ligger under URL-en `https://api.instatus.com`. De følger stort sett REST-arkitekturen.

Alle forespørsler må kodes som JSON med headeren `Content-Type: application/json`.

Svar fra Instatus-API-et, inkludert feil, er også kodet som JSON.

## Autentisering

Forespørsler til Instatus-API-et må oppgi et API-token i Authorization-headeren:

Du finner API-nøkkelen din under Brukerinnstillinger → [Utviklerinnstillinger](https://dashboard.instatus.com/developer)

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

## Finn side-ID-en din
Du finner side-ID-en din i dashbordet slik:
1. Gå til dashbordet ditt.
2. Høyreklikk på prosjektet ditt øverst til venstre for å åpne menyen.
3. Klikk **Kopier prosjekt-ID**, så kopieres side-ID-en din til utklippstavlen.

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

## Feil

Alle API-endepunkter returnerer en kode og en melding i feilsvarene.

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

## Statusverdier

Mulige sidestatuser. Dette er den detaljerte `status`-verdien som returneres av det gjeldende API-et (v2 og nyere). Det gamle `summary.json`-endepunktet og [webhook-varslinger](https://instatus.com/help/no/webhooks) bruker en forenklet form med bare `UP`, `HASISSUES` og `UNDERMAINTENANCE`.

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

Mulige komponentstatuser:

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

Mulige hendelsesstatuser:

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

Mulige vedlikeholdsstatuser:

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

## Hopp til endepunktene:

- [Statussider](https://instatus.com/help/no/api/status-pages)
- [Arbeidsområder](https://instatus.com/help/no/api/workspaces)
- [Komponenter](https://instatus.com/help/no/api/components)
- [Hendelser](https://instatus.com/help/no/api/incidents)
- [Hendelsesoppdateringer](https://instatus.com/help/no/api/incident-updates)
- [Vedlikehold](https://instatus.com/help/no/api/maintenances)
- [Vedlikeholdsoppdateringer](https://instatus.com/help/no/api/maintenance-updates)
- [Maler](https://instatus.com/help/no/api/templates)
- [Generelle kunngjøringer](https://instatus.com/help/no/api/generic-notices)
- [Avbrudd](https://instatus.com/help/no/api/outages)
- [Teammedlemmer](https://instatus.com/help/no/api/teammates)
- [Abonnenter](https://instatus.com/help/no/api/subscribers)
- [Måledata](https://instatus.com/help/no/api/metrics)
- [Brukerprofil](https://instatus.com/help/no/api/user-profile)
- [Offentlige data](https://instatus.com/help/no/api/public-data)
- [Private sider](https://instatus.com/help/no/api/private-pages)
- [Målgrupper](https://instatus.com/help/no/api/audience-groups)
- [Monitorer](https://instatus.com/help/no/api/monitors)
- [Overvåkingsintegrasjoner](https://instatus.com/help/no/api/monitoring-integrations)
- [Rutingregler](https://instatus.com/help/no/api/routing-rules)
- [Eskaleringspolicyer](https://instatus.com/help/no/api/escalation-policies)
- [Vaktplaner](https://instatus.com/help/no/api/on-call-schedules)