Kode Error
Arti setiap kode error Se-Hari API, penyebab yang paling sering, dan cara memperbaikinya.
Kode Error
- invalid_request — Body request tidak lolos validasi HTTP 400. Request Anda sampai ke endpoint yang benar dengan kredensial yang benar, tapi isinya tidak sesuai bentuk yang diharapkan. Validasi terjadi…
- invalid_parameter — Parameter query tidak valid HTTP 400. Salah satu parameter di query string tidak bisa dibaca atau berada di luar rentang yang diizinkan. Seperti `invalid_request`, ini terjadi…
- invalid_cursor — Cursor paginasi tidak bisa dibaca HTTP 400. Nilai `starting_after` yang Anda kirim bukan cursor yang pernah kami keluarkan. Cursor bersifat buram: ia menyandikan posisi baris terakhir dan…
- malformed_json — Body bukan JSON yang valid HTTP 400. Kami tidak berhasil mem-parse body request sebagai JSON. Ini terjadi sebelum validasi field, jadi tidak ada informasi tentang field mana yang…
- missing_authorization — Header Authorization tidak dikirim HTTP 401. Request sampai tanpa header `Authorization` sama sekali. Ini berbeda dari `invalid_api_key`, yang berarti header ada tapi isinya ditolak.
- invalid_api_key — API key ditolak HTTP 401. Header `Authorization` ada, tapi key di dalamnya tidak kami kenali, sudah dicabut, atau sudah lewat masa berlakunya. Ketiga kondisi itu sengaja…
- insufficient_scope — API key kurang izin HTTP 403. Key Anda valid dan dikenali, tapi tidak punya scope yang dibutuhkan endpoint ini. Perbedaan antara 401 dan 403 di sini bermakna: 401 berarti…
- insufficient_credits — Kredit tidak cukup HTTP 403. Operasi ini membutuhkan lebih banyak kredit daripada yang tersisa di akun Anda. Tidak ada yang dikerjakan dan tidak ada yang terpotong —…
- credit_cap_exceeded — Batas kredit harian API key tercapai HTTP 403. Saldo Anda masih ada, tapi API key yang dipakai sudah menyentuh batas kredit hariannya. Batas ini Anda sendiri yang menetapkannya di dashboard…
- forbidden — Operasi tidak diizinkan HTTP 403. Anda punya izin secara scope, tapi operasinya tidak sah pada kondisi data saat ini. Berbeda dari `insufficient_scope`, yang bisa diperbaiki…
- not_found — Data tidak ditemukan HTTP 404. Tidak ada data dengan id tersebut yang bisa Anda akses. Perhatikan kalimat itu: data milik akun lain juga dijawab 404, bukan 403. Menjawab 403…
- method_not_allowed — Method HTTP tidak didukung HTTP 405. Path-nya benar, tapi method yang Anda pakai tidak tersedia di sana. Header `Allow` pada respons menyebutkan method apa saja yang bisa dipakai.
- conflict — Bentrok dengan kondisi data saat ini HTTP 409. Permintaan Anda sah, tapi ada sesuatu yang sudah menempati posisi itu. Ini bukan kegagalan — di banyak kasus, `details` justru berisi id data…
- idempotency_key_reused — Idempotency-Key dipakai untuk isi yang berbeda HTTP 409. Anda mengirim `Idempotency-Key` yang sudah pernah dipakai, tapi dengan body yang berbeda. Kami menolaknya alih-alih menebak mana yang Anda…
- gone — Data sudah tidak tersedia HTTP 410. Data ini pernah ada, tapi masa simpannya sudah lewat. Berbeda dari 404 yang berarti "tidak pernah ada atau bukan milik Anda", 410 adalah…
- file_too_large — Berkas melebihi batas ukuran HTTP 413. Ukuran berkas yang Anda sebutkan melebihi batas yang bisa kami proses. Pemeriksaan terjadi saat meminta URL unggah, sebelum satu byte pun…
- unsupported_media_type — Content-Type tidak didukung HTTP 415. Endpoint ini mengharapkan `Content-Type` tertentu dan menerima yang lain. Untuk seluruh endpoint JSON, nilainya harus `application/json`.
- unprocessable_entity — Bentuk benar, isinya tidak bisa diproses HTTP 422. Body Anda lolos validasi bentuk, tapi isinya tidak masuk akal untuk dikerjakan. Ini lapisan pemeriksaan setelah validasi skema — yang memeriksa…
- rate_limited — Terlalu banyak request HTTP 429. Anda melewati batas jumlah request dalam satu jendela waktu. Batas dihitung **per API key**, bukan per alamat IP — di Indonesia banyak pengguna…
- internal_error — Kesalahan di sisi kami HTTP 500. Sesuatu gagal di dalam sistem kami. Request Anda mungkin sudah sebagian dikerjakan atau tidak sama sekali — itulah kenapa `Idempotency-Key`…
- upstream_error — Layanan pihak ketiga menolak HTTP 502. Kami meneruskan permintaan Anda ke layanan lain — Zoom untuk meeting, penyedia AI untuk transkripsi — dan layanan itu yang gagal. Masalahnya…
- service_unavailable — Layanan sedang tidak tersedia HTTP 503. Kami sedang tidak bisa melayani permintaan ini untuk sementara. Berbeda dari 500 yang berarti sesuatu rusak, 503 berarti sesuatu sedang tidak…