Baca seluruh respons
Bagi status yang tidak berjaya, simpan kod HTTP, pengepala, badan ralat dan ID permintaan selepas membuang rahsia. Ini membezakan permintaan tidak sah daripada penolakan akses atau masalah sementara.
Jangan dedahkan respons perkhidmatan mentah sebagai satu-satunya mesej pengguna: terangkan tindakan sambil mengekalkan butiran diagnostik untuk pengendali.
Periksa respons yang gagal
bash
curl --include --request POST https://cicora.ai/api/v1/chat/completions \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"model":"openai/gpt-5.6-sol","messages":[]}'Kelaskan kegagalan
- 4xx biasanya memerlukan pembetulan kunci, data input atau akses.
- 429 memerlukan pematuhan tetingkap had dan pengelakan percubaan semula yang agresif.
- Kegagalan 5xx dan kegagalan rangkaian memerlukan percubaan semula terbatas dengan sela tunggu yang meningkat secara eksponen serta variasi masa rawak.
Cuba semula dengan selamat
Cuba semula hanya kegagalan sementara dan hanya jika operasi itu idempoten dalam produk anda. Untuk penjanaan, simpan ID permintaan klien bagi mencegah caj berganda atau artifak pendua.
Dalam penstriman, bezakan ralat sebelum delta pertama daripada gangguan selepas output separa: yang terakhir tidak boleh digantikan secara senyap dengan respons baharu.