Tangani error dan rate limit
Gunakan envelope error, Retry-After, dan idempotensi untuk retry yang aman.
Error JSON memiliki success: false, error, message, dan bila tersedia details serta requestId. Simpan requestId saat meminta bantuan, tetapi jangan simpan secret atau capability token di log.
| Status | Tindakan |
|---|---|
401 | Periksa X-API-Key, masa berlaku, dan apakah key sudah dicabut. |
403 | Periksa scope key dan akses workspace. |
409 | Pertahankan payload dan Idempotency-Key yang sama; jangan membuat duplikasi. |
422 | Perbaiki field, UUID, variabel, tanggal, atau bentuk message yang ditolak. |
429 | Hormati rate limit. Jika ada header Retry-After, tunggu jumlah detik tersebut lalu retry dengan backoff. |
502 | Jika hasil request tidak diketahui, retry dengan idempotency key yang sama. |
Rate limit juga dapat berlaku pada pembacaan attachment. Jangan melakukan retry cepat tanpa batas. Request yang sudah diterima tetap asynchronous, jadi gunakan status delivery untuk memastikan hasil akhir.
Tidak ada playground bercredential di dokumentasi. Jalankan contoh dari server kamu dan simpan key sebagai environment variable.