Copy page

Developer

Rate Limit dan Error

Halaman ini membantu integrasi Anda mengatur laju kirim dan menangani galat dengan benar.

Batas laju

• Umum: 100 permintaan per menit per API key, dengan jendela tetap satu menit.
• Pengiriman pesan punya batas tambahan per channel: WhatsApp 60 pesan per menit, Instagram dan Messenger 180 pesan per jam.

Setiap respons membawa header berikut.

Code
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 42
X-RateLimit-Reset: <waktu-reset>

Kode galat

Status	Arti	Tindakan
401	Key tidak ada, formatnya salah, tidak valid, dicabut, atau kedaluwarsa.	Periksa key. Lihat Autentikasi.
403	Key tidak punya scope yang dibutuhkan (insufficient_scope).	Buat key baru dengan scope itu. Jangan diulang.
429	Batas laju terlampaui.	Tunggu sesuai header Retry-After.
503	Server sedang melayani permintaan sebanyak batasnya (ServerBusy).	Ulangi setelah Retry-After.

403 insufficient_scope

Isi galat menyebut scope yang kurang (need) dan scope yang dimiliki key (granted).

Code
{
  "success": false,
  "error": {
    "code": "insufficient_scope",
    "message": "This API key is missing the scope 'messages:write' ...",
    "need": "messages:write",
    "granted": ["customers:read", "conversations:read"]
  }
}

Scope key tidak bisa diubah, jadi solusinya adalah membuat key baru. Lihat API Key dan Scope.

429 Rate limit

Code
{
  "error": {
    "code": "RateLimitExceeded",
    "message": "...",
    "retryAfter": 30
  }
}

Respons juga membawa header Retry-After (detik). Implementasikan jeda dan percobaan ulang bertahap di integrasi Anda.

503 ServerBusy

Respons berisi error.code bernilai ServerBusy dan header Retry-After: 1. Ini bukan batas laju: permintaan belum dimulai, sehingga aman diulang setelah jeda.

Hasil yang diharapkan

Integrasi Anda membaca Retry-After, mengulang hanya pada 429 dan 503, dan tidak mengulang 401 atau 403 tanpa mengubah key.

Masalah umum

• Pesan WhatsApp ditolak di luar jendela 24 jam: kirim template. Lihat Konsep Dasar.
• Sering kena 429: kurangi laju kirim, atau bagi beban dengan jeda antarpermintaan.