Nggarap kesalahan API lan nyoba maneh
Diagnosa kesalahan otentikasi ShareAI, ruang lingkup, akses model lan kasedhiyan tanpa tulisan duplikat utawa upaya refresh sing ora aman.
Ing kaca iki
Tansah priksa status HTTP sadurunge maca respon minangka sukses. Layanan ShareAI bisa ngasilake amplop kesalahan sing beda: inferensi bisa nyedhiyakake error.code, OAuth nyedhiyakake error lan error_description, lan rute Console bisa ngasilake code, message lan data.status.
| Status | Makna khas | Pemulihan |
|---|---|---|
| 200 kanthi obyek kesalahan | Ora ana kasedhiyan piranti ing titik pungkasan obrolan saiki. | Priksa error.code lan aja nggambarake minangka jawaban asisten. |
| 400 | Panjalukan ora sah utawa OAuth grant. | Benerake awak, paramèter, callback utawa kode kadaluwarsa/dianggo. |
| 401 | Otentikasi ilang, kadaluwarsa utawa ora sah. | Priksa kredensial; refresh mung hibah OAuth sing sah. |
| 402 | Kredit utawa saldo sing cocog ora cukup. | Priksa saldo akun sing dipilih sadurunge nyoba maneh. |
| 403 | Penolakan lingkup, kepemilikan, peran utawa status aktif. | Priksa watesan idin sing didokumentasikake. |
| 404 | Sumber ora dikenal utawa rute gateway ora didhukung. | Priksa host, path lan pengenal sumber. |
| 409 | Konflik status utawa revisi. | Waca status saiki lan pertimbangake owah-owahan kasebut. |
| 429 | Watesan panjalukan utawa konkuren. | Hormati Retry-After lan gunakake backoff sing diwatesi. |
| 500 / 502 / 503 | Gagal kasedhiyan server utawa upstream. | Tetep retry diwatesi; jaga pengenal diagnostik. |
Refresh maca kanthi watesan#
Kanggo kegagalan sementara ing maca, enteni kanthi delay lan jitter sing tambah, hormati Retry-After yen ana lan mandheg sawise upaya utawa anggaran wektu sing ditemtokake. Tampilake pangguna nalika data ora kasedhiya tinimbang looping kanthi bisu.
Tangani tulisan kanthi ati-ati#
Aja otomatis mbaleni nganyari rega, nggawe model utawa perintah sharing nalika asil ora dingerteni. Waca status sumber utawa perintah dhisik. Gunakake Idempotency-Key mung ing titik pungkasan sing ndhukung dokumentasi, kayata owah-owahan persetujuan.
Token refresh iku siji-pangguna#
Refresh rotasi mbutuhake kunci per-otorisasi ing backend sampeyan. Retry buta token refresh sing dianggo bisa mbatalake hibah. Deleng refresh token sing aman.
Apa sing kudu kalebu ing panjalukan dhukungan#
Kalebu titik pungkasan, status HTTP, kode kesalahan, wektu lan pengenal respon/tugas yen kasedhiya. Copot header Authorization, cookie, rahasia klien, token akses, token refresh lan isi prompt pribadi.
Paling anyar dianyari Septèmber 15, 2026