# Începe cu API-ul Instatus

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

Toate endpointurile se află sub URL-ul `https://api.instatus.com`. În general, respectă arhitectura REST.

Toate cererile trebuie codate ca JSON, cu headerul `Content-Type: application/json`.

Răspunsurile de la API-ul Instatus, inclusiv erorile, sunt codate tot ca JSON.

## Autentificare

Cererile către API-ul Instatus trebuie să furnizeze un token API prin headerul Authorization:

Îți poți obține cheia API din Setările utilizatorului → [Setări pentru dezvoltatori](https://dashboard.instatus.com/developer)

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

## Obține ID-ul paginii tale
ID-ul paginii tale poate fi găsit în panou, urmând acești pași:
1. Mergi la panoul tău.
2. Dă clic dreapta pe proiectul tău din colțul din stânga sus, ca să deschizi meniul.
3. Dă clic pe **Copy Project ID** și ID-ul paginii tale se copiază în clipboard.

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

## Erori

Toate endpointurile API includ un cod și un mesaj în răspunsurile de eroare.

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

## Valorile stărilor

Stări posibile ale paginii. Aceasta este starea detaliată (`status`) întoarsă de API-ul actual (v2 și ulterior). Endpointul vechi `summary.json` și [notificările prin webhook](https://instatus.com/help/ro/webhooks) folosesc o formă condensată, doar cu `UP`, `HASISSUES` și `UNDERMAINTENANCE`.

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

Stări posibile ale componentelor:

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

Stări posibile ale incidentelor:

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

Stări posibile ale mentenanțelor:

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

## Sari la endpointuri:

- [Pagini de stare](https://instatus.com/help/ro/api/status-pages)
- [Spații de lucru](https://instatus.com/help/ro/api/workspaces)
- [Componente](https://instatus.com/help/ro/api/components)
- [Incidente](https://instatus.com/help/ro/api/incidents)
- [Actualizări de incident](https://instatus.com/help/ro/api/incident-updates)
- [Mentenanțe](https://instatus.com/help/ro/api/maintenances)
- [Actualizări de mentenanță](https://instatus.com/help/ro/api/maintenance-updates)
- [Șabloane](https://instatus.com/help/ro/api/templates)
- [Anunțuri generale](https://instatus.com/help/ro/api/generic-notices)
- [Întreruperi](https://instatus.com/help/ro/api/outages)
- [Membrii echipei](https://instatus.com/help/ro/api/teammates)
- [Abonați](https://instatus.com/help/ro/api/subscribers)
- [Metrici](https://instatus.com/help/ro/api/metrics)
- [Profilul utilizatorului](https://instatus.com/help/ro/api/user-profile)
- [Date publice](https://instatus.com/help/ro/api/public-data)
- [Pagini private](https://instatus.com/help/ro/api/private-pages)
- [Grupuri de audiență](https://instatus.com/help/ro/api/audience-groups)
- [Monitoare](https://instatus.com/help/ro/api/monitors)
- [Integrări de monitorizare](https://instatus.com/help/ro/api/monitoring-integrations)
- [Reguli de rutare](https://instatus.com/help/ro/api/routing-rules)
- [Politici de escaladare](https://instatus.com/help/ro/api/escalation-policies)
- [Programe de gardă](https://instatus.com/help/ro/api/on-call-schedules)