Tangani kesalahan API dan coba ulang

Selalu periksa status HTTP sebelum membaca respons sebagai keberhasilan. Layanan ShareAI dapat mengembalikan amplop kesalahan yang berbeda: inferensi dapat menyediakan error.code, OAuth menyediakan error dan error_description, dan rute Console dapat mengembalikan code, message dan data.status.

Status	Arti umum	Pemulihan
200 dengan objek kesalahan	Hasil ketersediaan tanpa perangkat di endpoint chat saat ini.	Periksa error.code dan jangan tampilkan sebagai jawaban asisten.
400	Permintaan tidak valid atau OAuth grant.	Koreksi badan, parameter, callback, atau kode yang kedaluwarsa/terpakai.
401	Autentikasi hilang, kedaluwarsa, atau tidak valid.	Periksa kredensial; segarkan hanya jika grant OAuth valid.
402	Kredit atau saldo yang berlaku tidak mencukupi.	Periksa saldo akun yang dipilih sebelum mencoba lagi.
403	Penolakan cakupan, kepemilikan, peran, atau status yang diaktifkan.	Periksa batas izin yang telah didokumentasikan.
404	Sumber daya tidak dikenal atau rute gateway tidak didukung.	Periksa host, jalur, dan pengidentifikasi sumber daya.
409	Konflik status atau revisi.	Baca status saat ini dan pertimbangkan kembali perubahan tersebut.
429	Permintaan atau batasan konkuren.	Hormati Retry-After dan gunakan backoff yang terbatas.
500 / 502 / 503	Kegagalan ketersediaan server atau upstream.	Pertahankan batas retry; jaga pengidentifikasi diagnostik.

Coba baca ulang dengan batas#

Untuk kegagalan sementara pada pembacaan, tunggu dengan penundaan yang meningkat dan jitter, hormati Retry-After jika ada, dan berhenti setelah upaya atau anggaran waktu yang ditentukan. Tampilkan kepada pengguna saat data tidak tersedia daripada terus berulang secara diam-diam.

Perlakukan penulisan dengan hati-hati#

Jangan secara otomatis mengulangi pembaruan harga, pembuatan model, atau perintah berbagi saat hasilnya tidak diketahui. Baca status sumber daya atau perintah terlebih dahulu. Gunakan Idempotency-Key hanya pada endpoint yang mendokumentasikan dukungan, seperti perubahan perjanjian.

Token penyegaran hanya dapat digunakan sekali#

Penyegaran rotasi membutuhkan kunci otorisasi per-otorisasi di backend Anda. Retry buta dari token penyegaran yang telah digunakan dapat mencabut izin. Lihat penyegaran token yang aman.

Apa yang harus disertakan dalam permintaan dukungan#

Sertakan endpoint, status HTTP, kode kesalahan, waktu, dan pengidentifikasi respons/tugas jika tersedia. Hapus header Authorization, cookie, rahasia klien, token akses, token penyegaran, dan konten prompt pribadi.

Batas pengeluaran bulanan dan pemulihan tagihan#

Setiap akun berbayar dapat menetapkan batas pengeluaran bulanan AI-nya sendiri per aplikasi atau layanan klien di Billing → Subscriptions & Commitments. Batas tersebut mencakup biaya jaringan dan biaya tambahan builder, sementara langganan tetap dan pembelian yang dikonfirmasi tetap terpisah. Kesalahan batas menggunakan HTTP 402 application_spending_limit_exceeded; kredit yang memenuhi syarat tidak mencukupi menggunakan HTTP 402 insufficient_credits. Keduanya menyediakan tautan tagihan pelanggan. Kontrak kesalahan, penanganan streaming, dan contoh integrasi.