Kesalahan & Batasan – Dokumentasi ByByBG
❌ Kesalahan & Batasan

Kesalahan & Batasan API

Pahami kode status API, batasan unggahan, batas permintaan, dan solusi pemecahan masalah untuk aplikasi produksi.

IKHTISAR

Memahami Respons API

API ByByBG mengembalikan kode status HTTP standar untuk menunjukkan permintaan yang berhasil, kegagalan, batasan unggahan, dan batas rate limit.

Tips: Selalu tangani kesalahan API dengan benar dalam aplikasi produksi untuk stabilitas dan pengalaman pengguna yang lebih baik.
STATUS CODES

Kode Status HTTP Umum

Code
Description
200
Latar belakang berhasil dihapus.
400
Permintaan tidak valid atau file gambar tidak ada.
401
API Key tidak ada atau tidak valid.
403
Akses ditolak.
413
File gambar yang diunggah terlalu besar.
415
Format gambar tidak didukung.
429
Terlalu banyak permintaan. Batas rate limit terlampaui.
500
Kesalahan pemrosesan server internal.
503
Layanan sementara tidak tersedia.
LIMITS

Batasan Unggahan

  • Ukuran gambar maksimum yang didukung: 10MB.
  • Format yang didukung: PNG, JPG, JPEG, dan WEBP.
  • Format output transparan: PNG.
  • Permintaan API dapat dikenakan batas rate limit.
  • Unggahan besar dapat meningkatkan waktu pemrosesan.
TROUBLESHOOTING

Masalah Umum & Solusi

🔐

API Key Tidak Valid

Periksa API Key dan header permintaan Anda sebelum mengirim permintaan.

📦

Gambar Terlalu Besar

Kompres gambar sebelum mengunggah untuk mengurangi ukuran file dan meningkatkan kecepatan.

🌐

Kesalahan Jaringan

Periksa koneksi internet dan ketersediaan server backend.

Rate Limit

Kurangi frekuensi permintaan atau tingkatkan paket API Anda.

BEST PRACTICES

Rekomendasi Produksi

  • Gunakan mekanisme retry untuk permintaan yang gagal.
  • Tampilkan pesan kesalahan yang ramah pengguna.
  • Validasi unggahan sebelum mengirim file.
  • Kompres gambar besar sebelum diunggah.
  • Simpan cache respons yang berhasil jika memungkinkan.
  • Pantau penggunaan API dan batas permintaan.
ERROR RESPONSE

Contoh Respons Kesalahan JSON

{
  "success": false,
  "error": "Invalid API key"
}

Dokumentasi Selesai

Sekarang Anda siap mengintegrasikan API ByByBG ke dalam situs web, aplikasi mobile, platform SaaS, dan sistem otomatisasi.