Kode status

Setelah melakukan panggilan API atau SDK ke AI Search Open Platform, kode status akan dikembalikan untuk menunjukkan hasil dari panggilan tersebut. Detail hasil panggilan dapat ditemukan berdasarkan parameter code dan status.

Tabel berikut menjelaskan kode status umum dari AI Search Open Platform.

Kategori	Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
Kesalahan permintaan	400	InvalidParameter	Parameter yang diperlukan tidak ada atau tidak valid, silakan periksa parameter permintaan.	Satu atau lebih parameter permintaan tidak valid.
	400	ServiceIdNotExist	service_id tidak ada.	ID layanan tidak ada.
	429	Throttling	Pembatasan kecepatan permintaan terpicu.	Panggilan API memicu pembatasan kecepatan.
	429	Throttling.RateQuota	Batas laju permintaan terlampaui, silakan coba lagi nanti.	Frekuensi panggilan memicu pembatasan kecepatan, seperti jumlah permintaan per detik.
	429	Throttling.AllocationQuota	Kuota yang dialokasikan terlampaui, silakan tingkatkan batas kuota Anda.	Jumlah panggilan dalam periode waktu tertentu memicu pembatasan kecepatan, seperti jumlah token yang dihasilkan per menit.
	429	Throttling.AllocationQuota	Kuota gratis yang dialokasikan terlampaui.	Kuota gratis habis, dan akses berbayar model belum diaktifkan.
Kesalahan server	500	InternalServerError	Telah terjadi kesalahan internal, silakan coba lagi nanti atau hubungi dukungan layanan.	Telah terjadi kesalahan internal.

Contoh tanggapan

Jika panggilan ke AI Search Open Platform gagal, pesan yang berisi detail kesalahan akan dikembalikan bersama dengan kode status HTTP. Berikut adalah contoh tanggapan:

{
    "request_id": "817964CD-1B84-4AE1-9B63-4FB99734DD41",
    "latency": 0,
    "code": "InvalidParameter",
    "message": "JSON parse error: Invalid UTF-8 start byte 0xbc; nested exception is com.fasterxml.jackson.core.JsonParseException: Invalid UTF-8 start byte 0xbc\n at line: 2, column: 19]"
}

Parameter tanggapan

Parameter	Tipe	Deskripsi
Kode status HTTP	integer	Kode status 200 menunjukkan bahwa permintaan berhasil. Kode status lainnya menunjukkan bahwa permintaan gagal. Jika permintaan gagal, kode kesalahan dan pesan kesalahan yang sesuai dikembalikan untuk parameter code dan message.
request_id	string	ID permintaan. Untuk menganalisis kegagalan permintaan, Anda dapat menemukan permintaan berdasarkan nilai parameter request_id.
code	string	Kode kesalahan yang dikembalikan jika terjadi kegagalan. Untuk informasi lebih lanjut, lihat kolom Kode kesalahan pada tabel sebelumnya.
message	string	Pesan yang dikembalikan jika terjadi kegagalan. Untuk informasi lebih lanjut, lihat kolom Pesan kesalahan pada tabel sebelumnya. Perhatikan bahwa pesan dapat bervariasi berdasarkan skenario aktual dan mungkin berisi informasi lebih spesifik yang berbeda dari tabel sebelumnya.