> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wator.id/llms.txt
> Use this file to discover all available pages before exploring further.

# API keys

> Buat, batasi, revoke, dan hapus API key untuk integrasi Wator.

API key memberi akses programatis ke API Wator.

<Note>
  Coba request langsung di [API Playground](https://api.wator.id/v1/docs).
</Note>

## Membuat API key

1. Buka **Developer**.
2. Pilih tab **API Keys**.
3. Klik buat key.
4. Isi nama key.
5. Pilih minimal satu izin.
6. Simpan raw key yang ditampilkan.

<Warning>
  Raw API key hanya ditampilkan saat dibuat. Simpan di tempat aman dan jangan bagikan ke pihak yang tidak berwenang.
</Warning>

## Izin API key

Izin menentukan aksi API yang bisa dipakai. Contoh izin:

* Read device untuk `GET /v1/devices` dan `GET /v1/devices/{deviceID}`.
* Send message untuk pengiriman pesan.

## Rate limit

Setiap API key memiliki limit baca dan limit pengiriman pesan per menit. Jika limit terlewati, API mengembalikan `429` dengan kode `rate_limit_exceeded`.

## Revoke atau delete

Gunakan revoke untuk menonaktifkan key tanpa menghapus record. Gunakan delete jika key tidak lagi diperlukan.