# Mulai menggunakan API Instatus

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

Semua endpoint berada di bawah URL `https://api.instatus.com`. Endpoint umumnya mengikuti arsitektur REST.

Semua permintaan harus dikodekan sebagai JSON dengan header `Content-Type: application/json`.

Respons dari API Instatus, termasuk galat, juga dikodekan sebagai JSON.

## Autentikasi

Permintaan ke API Instatus harus menyertakan token API lewat header Authorization:

Anda bisa mendapatkan kunci API dari Pengaturan pengguna → [Pengaturan pengembang](https://dashboard.instatus.com/developer)

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

## Mendapatkan ID Halaman Anda
ID Halaman Anda bisa ditemukan di dashboard dengan langkah berikut:
1. Buka dashboard Anda.
2. Klik kanan proyek Anda di pojok kiri atas untuk membuka menunya.
3. Klik **Copy Project ID** dan ID halaman Anda akan tersalin ke papan klip.

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

## Galat

Semua endpoint API memuat kode dan pesan di dalam respons galatnya.

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

## Nilai Status

Status halaman yang mungkin. Ini adalah `status` terperinci yang dikembalikan API saat ini (v2 dan setelahnya). Endpoint `summary.json` lama dan [notifikasi webhook](https://instatus.com/help/id/webhooks) memakai bentuk ringkas yang hanya berisi `UP`, `HASISSUES`, dan `UNDERMAINTENANCE`.

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

Status komponen yang mungkin:

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

Status insiden yang mungkin:

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

Status pemeliharaan yang mungkin:

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

## Lompat ke endpoint:

- [Halaman status](https://instatus.com/help/id/api/status-pages)
- [Ruang kerja](https://instatus.com/help/id/api/workspaces)
- [Komponen](https://instatus.com/help/id/api/components)
- [Insiden](https://instatus.com/help/id/api/incidents)
- [Pembaruan insiden](https://instatus.com/help/id/api/incident-updates)
- [Pemeliharaan](https://instatus.com/help/id/api/maintenances)
- [Pembaruan pemeliharaan](https://instatus.com/help/id/api/maintenance-updates)
- [Templat](https://instatus.com/help/id/api/templates)
- [Pemberitahuan umum](https://instatus.com/help/id/api/generic-notices)
- [Gangguan](https://instatus.com/help/id/api/outages)
- [Anggota tim](https://instatus.com/help/id/api/teammates)
- [Pelanggan langganan](https://instatus.com/help/id/api/subscribers)
- [Metrik](https://instatus.com/help/id/api/metrics)
- [Profil pengguna](https://instatus.com/help/id/api/user-profile)
- [Data publik](https://instatus.com/help/id/api/public-data)
- [Halaman privat](https://instatus.com/help/id/api/private-pages)
- [Grup audiens](https://instatus.com/help/id/api/audience-groups)
- [Monitor](https://instatus.com/help/id/api/monitors)
- [Integrasi pemantauan](https://instatus.com/help/id/api/monitoring-integrations)
- [Aturan perutean](https://instatus.com/help/id/api/routing-rules)
- [Kebijakan eskalasi](https://instatus.com/help/id/api/escalation-policies)
- [Jadwal siaga](https://instatus.com/help/id/api/on-call-schedules)