Ditinjau 2026-11-10 · Versi API 2026-11-09 · Baca Markdown
Kesalahan, percobaan ulang, dan pemulihan
Kesalahan API menggunakan { "error": { "code": "…", "message": "…", "requestId": "…" } }
dengan kesalahan field opsional, kesalahan tujuan, petunjuk percobaan ulang, dan serah terima tindakan.
Simpan requestId untuk dukungan. Jangan mencatat kredensial, URL unggahan bertanda tangan, atau
isi permintaan yang sensitif saat mengumpulkan diagnostik.
| Respons | Pemulihan |
|---|---|
401 unauthenticated | Periksa kunci produk yang hilang, rusak formatnya, atau dicabut |
403 forbidden_scope / account_not_allowed | Tinjau cakupan kunci dan akses tujuan |
402 account_limit, seat_limit, storage_limit | Tinjau hak ruang kerja dan penggunaan sumber daya |
402 subscription_inactive / trial_expired | Selesaikan status penagihan; pertahankan draf dan pekerjaan dalam antrean |
409 revision_conflict | Baca versi terkini, tinjau perubahan, dan terapkan ulang secara sengaja |
409 idempotency_conflict | Kunci digunakan ulang dengan isi berbeda; rekonsiliasi operasi aslinya |
409 consent_required | Minta orang berwenang menyelesaikan serah terima peninjauan yang diberikan |
409 too_late_to_cancel | Periksa status pengiriman sebenarnya; jangan klaim pembatalan berhasil |
media_expired / media_deleting | Unggah ulang berkas asli dan perbarui draf |
422 validation_failed | Perbaiki field terstruktur atau isu per tujuan |
429 rate_limited | Hormati Retry-After; kurangi konkurensi dan gunakan backoff |
submission_unknown | Rekonsiliasi hasil eksternal yang ada sebelum mencoba pengiriman lain |
Percobaan ulang mutasi yang aman
Buat kunci idempotensi sebelum mutasi pertama dan simpan permintaan persisnya.
Jika respons hilang, operasi mungkin sudah berhasil. Putar ulang
permintaan yang sama dengan kunci yang sama; jangan membuat kunci baru hanya karena jaringan
timeout. Alat mutasi MCP menampilkan kuncinya kembali, termasuk pada
kegagalan transport_outcome_unknown. Adaptor tidak mencoba ulang mutasi secara otomatis.
Batas kecepatan teknis ruang kerja bukanlah kredit posting. Gunakan /usage untuk
informasi paket dan laju terkini. Mundur hanya untuk kesalahan sementara bila
memang tepat; mencoba ulang kesalahan otorisasi, validasi, atau persetujuan manusia tanpa
mengubah penyebabnya tidak akan membantu.
Keberhasilan parsial dan pengamatan
Batch publish/schedule yang diterima adalah kumpulan pengiriman independen. Simpan tanda terima yang berhasil dan tautan asli. Pulihkan tujuan yang gagal melalui endpoint percobaan ulangnya sendiri alih-alih membuat ulang seluruh batch. Utamakan webhook bertanda tangan; jika polling, gunakan jumlah percobaan berbatas dengan jeda yang meningkat dan eskalasikan pekerjaan yang belum selesai kepada orang.