# Zacznij korzystać z API Instatus

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

Wszystkie endpointy znajdują się pod adresem `https://api.instatus.com`. Zasadniczo są zgodne z architekturą REST.

Wszystkie żądania muszą być zakodowane jako JSON, z nagłówkiem `Content-Type: application/json`.

Odpowiedzi API Instatus, łącznie z błędami, również są kodowane jako JSON.

## Uwierzytelnianie

Żądania do API Instatus muszą przekazywać token API w nagłówku Authorization:

Swój klucz API znajdziesz w Ustawieniach użytkownika → [Ustawienia dewelopera](https://dashboard.instatus.com/developer)

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

## Znajdź swoje ID strony
ID strony znajdziesz w panelu, wykonując poniższe kroki:
1. Przejdź do swojego panelu.
2. Kliknij projekt w lewym górnym rogu prawym przyciskiem myszy, aby otworzyć menu.
3. Kliknij **Copy Project ID**, a ID strony zostanie skopiowane do schowka.

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

## Błędy

Wszystkie endpointy API zwracają w odpowiedziach błędu kod i komunikat.

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

## Wartości statusów

Możliwe statusy strony. To szczegółowy `status` zwracany przez bieżące API (v2 i nowsze). Starszy endpoint `summary.json` oraz [powiadomienia webhook](https://instatus.com/help/pl/webhooks) używają formy skróconej, obejmującej tylko `UP`, `HASISSUES` i `UNDERMAINTENANCE`.

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

Możliwe statusy komponentu:

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

Możliwe statusy incydentu:

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

Możliwe statusy przerwy technicznej:

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

## Przejdź do endpointów:

- [Strony statusu](https://instatus.com/help/pl/api/status-pages)
- [Workspace’y](https://instatus.com/help/pl/api/workspaces)
- [Komponenty](https://instatus.com/help/pl/api/components)
- [Incydenty](https://instatus.com/help/pl/api/incidents)
- [Aktualizacje incydentów](https://instatus.com/help/pl/api/incident-updates)
- [Prace serwisowe](https://instatus.com/help/pl/api/maintenances)
- [Aktualizacje przerw technicznych](https://instatus.com/help/pl/api/maintenance-updates)
- [Szablony](https://instatus.com/help/pl/api/templates)
- [Ogłoszenia ogólne](https://instatus.com/help/pl/api/generic-notices)
- [Awarie](https://instatus.com/help/pl/api/outages)
- [Członkowie zespołu](https://instatus.com/help/pl/api/teammates)
- [Subskrybenci](https://instatus.com/help/pl/api/subscribers)
- [Metryki](https://instatus.com/help/pl/api/metrics)
- [Profil użytkownika](https://instatus.com/help/pl/api/user-profile)
- [Dane publiczne](https://instatus.com/help/pl/api/public-data)
- [Strony prywatne](https://instatus.com/help/pl/api/private-pages)
- [Grupy odbiorców](https://instatus.com/help/pl/api/audience-groups)
- [Monitory](https://instatus.com/help/pl/api/monitors)
- [Integracje monitoringu](https://instatus.com/help/pl/api/monitoring-integrations)
- [Reguły kierowania](https://instatus.com/help/pl/api/routing-rules)
- [Zasady eskalacji](https://instatus.com/help/pl/api/escalation-policies)
- [Grafiki dyżurów](https://instatus.com/help/pl/api/on-call-schedules)