Batas & Galat API

Batas permintaan, format galat seragam, daftar kode, dan kapan permintaan boleh diulang.

± 3 menit

Batas#

Permintaan per kunci	60/menit, lonjakan 20 per 10 detik
Permintaan per Profil (semua kunci)	120/menit, lonjakan 40 per 10 detik
Analitik WhatsApp per Profil	10/menit
Cek Mayar langsung (refresh=true)	sekali per 30 detik per tagihan, 10/menit per Profil
Media per Profil	1.024 MB/hari (masa coba 100 MB), 2 unggahan bersamaan
Permintaan per IP	240/menit
Badan JSON	≤ 64 KB; unggah media ≤ 50 MB
URL webhook	5 per Profil
Kunci aktif	20 per Profil
Idempotency-Key	disimpan 24 jam
Log	14 hari

Setiap respons membawa X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset; galat 429 membawa Retry-After (detik).

Format galat#

Galat

{
  "error": {
    "code": "validasi",
    "message": "text.body: Too small: expected string to have >=1 characters",
    "detail": [
      {
        "path": "text.body",
        "message": "Too small"
      }
    ]
  }
}

Daftar kode#

`tidak_ditemukan`	HTTP 404
`metode_tidak_didukung`	HTTP 405
`kunci_tidak_ada`	HTTP 401
`kunci_tidak_sah`	HTTP 401
`kunci_di_url_dilarang`	HTTP 400
`kunci_diblokir`	HTTP 403
`ip_diblokir`	HTTP 429
`ip_tidak_diizinkan`	HTTP 403
`izin_kurang`	HTTP 403
`paket_tidak_aktif`	HTTP 403
`fitur_tidak_aktif`	HTTP 403
`fitur_nonaktif`	HTTP 503
`mode_test_saja`	HTTP 403
`kuota_unggah_habis`	HTTP 429
`batas_permintaan`	HTTP 429
`server_sibuk`	HTTP 503
`badan_terlalu_besar`	HTTP 413
`badan_tidak_sah`	HTTP 400
`jenis_konten_salah`	HTTP 415
`validasi`	HTTP 422
`idempotency_key_wajib`	HTTP 400
`idempotency_key_tidak_sah`	HTTP 400
`idempotency_key_dipakai`	HTTP 422
`idempotensi_diproses`	HTTP 409
`kanal_tidak_ditemukan`	HTTP 404
`kanal_terputus`	HTTP 409
`kanal_wajib_dipilih`	HTTP 422
`di_luar_jendela_24_jam`	HTTP 422
`kontak_berhenti`	HTTP 422
`kuota_harian_habis`	HTTP 429
`jenis_tidak_didukung`	HTTP 422
`media_tidak_sah`	HTTP 422
`media_terlalu_besar`	HTTP 413
`url_tidak_aman`	HTTP 422
`template_tidak_ditemukan`	HTTP 422
`nomor_tidak_sah`	HTTP 422
`batas_tercapai`	HTTP 422
`konflik`	HTTP 409
`fitur_belum_diaktifkan`	HTTP 409
`gagal_kirim`	HTTP 502
`galat_server`	HTTP 500

Kapan mengulang?#

429 & 503: tunggu Retry-After lalu ulangi dengan Idempotency-Key yang sama.
5xx lain: ulangi dengan Idempotency-Key yang sama — pesan tidak akan ganda.
4xx lain: perbaiki permintaan; mengulang tanpa perubahan akan gagal lagi.