Referensi API

Penanganan Error

Kode error standar, header rate-limit, dan troubleshooting.

Terakhir diperbarui:

Penanganan Error

Semua respons error mengikuti format yang konsisten dengan kode error dan pesan yang dapat dibaca manusia:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Description of what went wrong"
  }
}

Kode Error

HTTP StatusCodeDescription
400VALIDATION_ERRORParameter permintaan tidak valid atau tidak ada
401UNAUTHORIZEDAPI key tidak ada atau tidak valid
402PAYMENT_REQUIREDKredit tidak mencukupi
403FORBIDDENAkses API memerlukan paket Business, atau tindakan tidak diizinkan
403LIMIT_EXCEEDEDBatas paket tercapai (proyek, build, dll.)
404NOT_FOUNDSumber daya tidak ditemukan atau tidak dapat diakses
409CONFLICTKonflik sumber daya (deployment sedang berjalan, domain sudah diambil, dll.)
429RATE_LIMITEDTerlalu banyak permintaan — periksa header batas laju
500INTERNAL_ERRORError server — coba lagi atau hubungi support

Header Batas Laju

Setiap respons menyertakan header berikut:

  • X-RateLimit-Remaining — Jumlah permintaan tersisa dalam jendela saat ini
  • X-RateLimit-Reset — Detik hingga jendela batas laju direset

Saat Anda menerima respons 429, tunggu sejumlah detik yang ditunjukkan oleh X-RateLimit-Reset sebelum mencoba ulang.

Biaya Kredit

Tindakan API yang menggunakan kredit:

ActionCredits
Buat proyek (build awal)5
Penyempurnaan1
Edit kode1
Redeploy1
Rollback1
Kloning2
Aktifkan kembali1
Pertanyaan Advisor1

Administrator dikecualikan dari biaya kredit.

Pemecahan Masalah

  • 401 Unauthorized — Pastikan API key Anda diawali dengan flp_ dan disertakan sebagai Bearer token
  • 403 Forbidden — Verifikasi akun Anda memiliki langganan Business aktif
  • 409 Conflict on deploy — Tunggu deployment saat ini selesai, atau batalkan terlebih dahulu
  • Subdomain errors — Subdomain harus berupa huruf kecil, 3-63 karakter, dan hanya berisi huruf, angka, dan tanda hubung
SebelumnyaAI Gateway (chat & generate)