Memulai

Error

Jika terjadi masalah, API merespons dengan status HTTP yang sesuai dan body berisi code serta message di dalam error.

Gunakan code di program Anda. message adalah teks berbahasa Inggris untuk membantu proses debugging dan dapat berubah.

Format error404

{
  "error": {
    "code": "not_found",
    "message": "Item not found or you do not have access to it."
  }
}

Tanpa kunci401

{
  "error": {
    "code": "missing_api_key",
    "message": "Send your API key in the X-API-Key header or as Authorization: Bearer <key>."
  }
}

Kode error

Status	Kode	Kapan terjadi
400	`key_in_query`	Kunci dikirim di URL (parameter `api_key`, `apikey`, `key`, atau `token`). Kirim kunci di header dan buat kunci baru, karena kunci sebelumnya mungkin sudah tercatat di log.
400	`invalid_parameter`	Sebuah parameter memiliki nilai yang tidak valid, misalnya `per_page` di atas batas maksimum.
401	`missing_api_key`	Permintaan tidak menyertakan kunci.
401	`invalid_api_key`	Kunci tidak ada, sudah dicabut, atau penggunanya dinonaktifkan.
404	`not_found`	Endpoint tidak ada, atau item tidak ada atau milik organisasi yang tidak dapat dilihat pengguna.
404	`organization_not_found`	`organization` yang diberikan bukan organisasi tempat pengguna dapat melihat jenis item ini.
405	`method_not_allowed`	API hanya menerima `GET` (dan `HEAD`).
429	`rate_limited`	Batas permintaan telah tercapai. Tunggu selama jumlah detik di `Retry-After`.
500	`server_error`	Error internal. Coba lagi sebentar lagi; jika masih terjadi, hubungi dukungan.

Kapan mencoba lagi

Ulangi permintaan yang sama hanya setelah 429 (dengan menunggu Retry-After) atau 500. Error lainnya memerlukan perbaikan pada permintaan atau kunci.