Kode error
Halaman ini adalah sumber kebenaran tunggal untuk penanganan error. Kode error khusus SDK didokumentasikan di halaman Error handling masing-masing SDK; halaman ini mencakup error di tingkat kontrak API.
Kode status HTTP
| Kode | Arti |
|---|---|
200 OK | Permintaan berhasil. |
400 Bad Request | Payload tidak valid atau field yang diperlukan tidak ada. Body mengidentifikasi field yang bermasalah. |
401 Unauthorized | Autentikasi tidak ada, kedaluwarsa, atau tidak valid. |
403 Forbidden | Autentikasi valid tetapi tenant tidak diaktifkan untuk resource yang diminta (misalnya, memanggil kemampuan yang tidak ada dalam APIKEY Anda). |
404 Not Found | Resource tidak ada atau tidak milik tenant yang terautentikasi. |
409 Conflict | Resource ada tetapi tidak dalam status yang tepat untuk operasi ini (misalnya, mengambil dokumen dari proses yang masih berlangsung). |
410 Gone | Resource pernah ada tetapi dihapus sesuai kebijakan retensi (endpoint pengambilan dokumen), atau proses ada tetapi berakhir dalam kondisi error — lihat Dapatkan Proses. |
429 Too Many Requests | Anda mencapai rate limit. Coba ulang dengan exponential backoff. |
5xx | Error platform. Coba ulang dengan backoff; jika persisten, hubungi dukungan dengan response body dan timestamp. |
Kebijakan retry
| Status | Harus dicoba ulang? | Cara |
|---|---|---|
5xx | Ya | Exponential backoff (1s, 2s, 4s, 8s, …). Batasi hingga 5 percobaan. |
429 | Ya | Patuhi header Retry-After jika ada; jika tidak, gunakan exponential backoff. |
4xx (lainnya) | Tidak | Permintaan salah. Perbaiki input sebelum mencoba ulang. |
401 | Kondisional | Refresh access token sekali. Jika permintaan baru juga mengembalikan 401, masalahnya struktural — jangan coba ulang. |
Platform IDCloud saat ini tidak mengekspos mekanisme idempotency-key pada endpoint pembuatan. Berhati-hatilah saat mencoba ulang Buat Proses — error jaringan pada 5xx mungkin sudah berhasil di sisi server, dan percobaan ulang akan membuat proses duplikat. Jika ragu, ambil proses terbaru berdasarkan ID korelasi internal Anda sebelum mencoba ulang.
Di mana error SDK berada
Katalog error Android SDK, iOS SDK, dan Flutter SDK didokumentasikan di halaman Error handling khusus masing-masing SDK:
Ini mencakup error di sisi perangkat (izin kamera ditolak, timeout pengambilan, jaringan tidak dapat dijangkau di perangkat) — terpisah dari error di sisi API yang didokumentasikan di sini.