# Kom igång med Instatus API

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

Alla endpoints finns under URL:en `https://api.instatus.com`. De följer i stort sett REST-arkitekturen.

Alla anrop måste vara kodade som JSON med headern `Content-Type: application/json`.

Svaren från Instatus API, inklusive fel, är också kodade som JSON.

## Autentisering

Anrop till Instatus API måste skicka med en API-token via Authorization-headern:

Du hittar din API-nyckel under Användarinställningar → [Utvecklarinställningar](https://dashboard.instatus.com/developer)

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

## Hämta ditt sid-ID
Du hittar ditt sid-ID i dashboarden så här:
1. Gå till din dashboard.
2. Högerklicka på ditt projekt uppe till vänster för att öppna menyn.
3. Klicka på **Kopiera projekt-ID** så kopieras ditt sid-ID till urklipp.

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

## Fel

Alla API-endpoints innehåller en kod och ett meddelande i felsvaren.

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

## Statusvärden

Möjliga sidstatusar. Det här är den detaljerade `status` som returneras av det nuvarande API:et (v2 och senare). Den äldre endpointen `summary.json` och [webhook-aviseringar](https://instatus.com/help/sv/webhooks) använder en förenklad form med bara `UP`, `HASISSUES` och `UNDERMAINTENANCE`.

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

Möjliga komponentstatusar:

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

Möjliga incidentstatusar:

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

Möjliga underhållsstatusar:

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

## Hoppa till endpoints:

- [Statussidor](https://instatus.com/help/sv/api/status-pages)
- [Arbetsytor](https://instatus.com/help/sv/api/workspaces)
- [Komponenter](https://instatus.com/help/sv/api/components)
- [Incidenter](https://instatus.com/help/sv/api/incidents)
- [Incidentuppdateringar](https://instatus.com/help/sv/api/incident-updates)
- [Underhåll](https://instatus.com/help/sv/api/maintenances)
- [Underhållsuppdateringar](https://instatus.com/help/sv/api/maintenance-updates)
- [Mallar](https://instatus.com/help/sv/api/templates)
- [Allmänna meddelanden](https://instatus.com/help/sv/api/generic-notices)
- [Avbrott](https://instatus.com/help/sv/api/outages)
- [Teammedlemmar](https://instatus.com/help/sv/api/teammates)
- [Prenumeranter](https://instatus.com/help/sv/api/subscribers)
- [Mätvärden](https://instatus.com/help/sv/api/metrics)
- [Användarprofil](https://instatus.com/help/sv/api/user-profile)
- [Publik data](https://instatus.com/help/sv/api/public-data)
- [Privata sidor](https://instatus.com/help/sv/api/private-pages)
- [Målgrupper](https://instatus.com/help/sv/api/audience-groups)
- [Övervakare](https://instatus.com/help/sv/api/monitors)
- [Övervakningsintegrationer](https://instatus.com/help/sv/api/monitoring-integrations)
- [Dirigeringsregler](https://instatus.com/help/sv/api/routing-rules)
- [Eskaleringspolicyer](https://instatus.com/help/sv/api/escalation-policies)
- [Jourscheman](https://instatus.com/help/sv/api/on-call-schedules)
