Integrasi & API
Batas Pemakaian dan Kode Error API
Batas permintaan per menit, bentuk pesan error, dan arti kode 400 sampai 429 pada API Jalinara, lengkap dengan tindakan perbaikannya.
Halaman ini untuk Anda atau tim teknis yang memanggil API Jalinara dari aplikasi lain. Isinya batas pemakaian, bentuk pesan error, arti tiap kode, dan apa yang perlu dilakukan saat permintaan ditolak.
Batas pemakaian
| Batas | Nilai per September 2026 | Catatan |
|---|---|---|
| Permintaan per token | 60 per menit | Lewat batas, API menjawab 429 |
| Kirim lewat API, paket Free | 20 pesan per menit, 1 nomor per permintaan | Dihitung per akun, bukan per token. Membuat token baru tidak menambah jatah |
| Target per permintaan | Maksimal 200 nomor | Lebih dari itu ditolak |
| Kuota dan warm-up | Tetap berlaku | Kuota pesan paket (penjelasannya) dan batas harian warm-up nomor baru (penjelasannya) |
Bentuk pesan error
Semua error dijawab dalam bentuk JSON dengan status bernilai false:
{ "status": false, "message": "...", "code": "..." }
message berisi penjelasan singkat, sedangkan code adalah kode tetap. Pakai status HTTP dan code untuk menentukan langkah berikutnya di aplikasi Anda.
Arti kode error
| HTTP | code |
Artinya | Tindakan |
|---|---|---|---|
| 400 | BAD_REQUEST |
Isi permintaan salah, misalnya target kosong atau lebih dari 200 target | Perbaiki isi permintaan. Jangan diulang apa adanya |
| 401 | UNAUTHORIZED |
Token tidak ada atau tidak valid | Periksa header Authorization: Bearer TOKEN_ANDA dan status token di menu API Token |
| 402 | UPGRADE_REQUIRED atau QUOTA_EXCEEDED |
Fitur belum termasuk paket, atau kuota habis | Naikkan paket, atau tunggu kuota di-reset |
| 403 | FORBIDDEN |
Token tidak berhak memakai perangkat yang diminta | Pakai token lain, atau hapus kolom device dari permintaan |
| 404 | NOT_FOUND |
Pesan, jadwal, atau perangkat tidak ditemukan | Periksa ID yang dikirim |
| 409 | CONFLICT |
Konflik pada Idempotency-Key: kunci yang sama dipakai untuk isi berbeda, atau permintaan dengan kunci itu masih diproses |
Isi berbeda: beri kunci baru. Masih diproses: tunggu sebentar, lalu ulangi dengan kunci yang sama |
| 429 | TOO_MANY_REQUESTS |
Permintaan melewati batas per menit | Tunggu sampai jatah pulih, lalu ulangi pelan-pelan |
Idempotency-Key adalah kode unik yang Anda tulis di header permintaan kirim. Kode yang sama membuat pengiriman ulang tidak menghasilkan pesan dobel. Caranya ada di Cara Mengirim dan Menjadwalkan Pesan lewat API.
Header sisa jatah (RateLimit-)
Setiap respons membawa header berawalan RateLimit-. Isinya batas, sisa jatah, dan kapan jatah dipulihkan. Pantau sisa jatah supaya aplikasi Anda berhenti sebelum kena 429.
Saat menerima 429, tunggu sampai waktu pulih sebelum mengirim lagi. Nama lengkap tiap header bisa Anda lihat di respons asli saat menguji API.
Kapan boleh mengulang permintaan
- Ulangi hanya untuk 429, 409 "sedang diproses", atau gangguan jaringan. Selalu dengan
Idempotency-Keyyang sama. - Jangan ulangi 400, 401, 402, 403, atau 404 sebelum penyebabnya diperbaiki. Hasilnya akan sama.
- Status
queuedhanya berarti pesan masuk antrean, bukan sudah sampai. Periksa status akhirnya di Log Pesan.
Belum ketemu jawabannya? Buka menu Bantuan di dashboard Jalinara dan kirim tiket ke tim kami.