Kesalahan & batas
Autentikasi dan validasi dapat menolak permintaan sebelum dijalankan. Lihat referensi kesalahan dan simpan request_id untuk dukungan. Jangan kirim kunci atau kata sandi.
Respons · HTTP
| HTTP | Keterangan |
|---|---|
400 / 422 | Periksa nama, tipe, batas, dan nilai parameter wajib. |
401 | Gunakan kunci aktif dalam header Authorization. |
403 | Periksa akses akun, izin efektif, verifikasi, dan daftar IP sumber API. |
404 | Periksa ID catatan sendiri; catatan akun lain tidak ditampilkan. |
409 | Baca ulang revision/harga dan rekonsiliasi operasi awal sebelum mengulang. |
429 | Tunggu Retry-After, lalu lanjutkan polling terbatas. |
5xx / timeout | Perubahan belum pasti bukan berarti gagal. Kueri operasi sama; jangan kirim pembelian atau perubahan baru. |
Kesalahan & batas · HTTP 429
Batas bawaan 60 permintaan per menit kalender; administrator dapat mengubahnya. Baca capabilities.limits dan patuhi Retry-After pada HTTP 429. Pembaruan kunci tidak menghapus penggunaan akun.
Retry-After: 15
{
"ok": false,
"error": { "code": "RATE_LIMITED" },
"meta": { "request_id": "000000000000000000000429" }
}Idempotency-Key
Simpan satu Idempotency-Key untuk setiap perubahan yang dimaksud. Timeout atau HTTP 5xx bukan bukti gagal. Periksa status dengan kunci sama; jangan gunakan kunci baru untuk mengulang hasil yang belum pasti.