Biteship menyediakan layanan API yang andal dan fleksibel untuk mengelola pengiriman. Untuk menjaga performa dan stabilitas layanan, Biteship menerapkan rate limit pada penggunaan API di lingkungan produksi dan sandbox. Rate limit mengacu pada jumlah maksimum permintaan (requests) yang dapat dikirim dalam waktu tertentu. Memahami batasan ini penting untuk memastikan bahwa aplikasi Anda berfungsi dengan baik tanpa gangguan, sambil tetap mengoptimalkan pengalaman pengguna.
Apa Itu Rate Limit?
Rate limit adalah batasan jumlah permintaan API yang dapat dikirimkan dalam periode waktu tertentu. Batasan ini diterapkan untuk menghindari beban berlebih pada server, memastikan kecepatan respons yang stabil, dan menjaga kualitas layanan.
Rate Limit pada API Biteship
Production Environment
| API | Production |
| Maps | 50 requests per seconds |
| Rates | 20 requests per seconds |
| Location | 10 requests per seconds |
| Order | 20 requests per seconds |
| Tracking | 50 requests per seconds |
| Draft Order | 20 requests per seconds |
| Courier | 10 requests per seconds |
Sandbox Environment
| API | Sandbox |
| Maps | 5 requests per second |
| Rates | 5 requests per second |
| Location | 5 requests per second |
| Order | 5 requests per second |
| Tracking | 5 requests per second |
| Draft Order | 5 requests per second |
| Courier | 5 requests per second |
Rate Limit API di Lingkungan Sandbox
Lingkungan sandbox adalah tempat bagi pengembang untuk menguji fitur dan integrasi API sebelum meluncurkannya di lingkungan produksi. Sandbox menyediakan ruang aman untuk simulasi tanpa memengaruhi data produksi.
• Tujuan: Pengujian integrasi API, verifikasi data, dan simulasi alur pengiriman.
• Rate Limit Sandbox: Rate limit di lingkungan sandbox biasanya lebih ketat dibandingkan lingkungan produksi untuk mengurangi beban pada server pengujian dan memantau pengujian yang tidak terkendali.
• Contoh Batasan: 100 requests per menit.
• Catatan: Rate limit ini mungkin bervariasi tergantung pada kebutuhan pengujian dan kebijakan terkini. Pengguna yang melebihi batasan rate limit akan menerima respons 429 Too Many Requests.
Tips untuk Penggunaan Optimal di Sandbox:
• Batch Requests: Cobalah mengirim permintaan secara bertahap, bukan dalam jumlah besar secara bersamaan.
• Log Aktivitas Pengujian: Catat aktivitas pengujian Anda untuk menghindari pengulangan permintaan yang tidak perlu.
• Optimalkan Pengujian: Fokuskan pengujian pada endpoint penting dan simulasikan skenario nyata.
Rate Limit API di Lingkungan Produksi
Lingkungan produksi adalah tempat Anda menjalankan operasi nyata dengan data langsung. Di sini, Anda mengelola pengiriman, pesanan, pelacakan, dan fitur lainnya untuk melayani pelanggan Anda.
• Tujuan: Mengelola pengiriman aktual, pelacakan, dan layanan operasional lainnya.
• Rate Limit Produksi: Rate limit di lingkungan produksi biasanya lebih longgar dibandingkan sandbox untuk mendukung volume transaksi yang lebih besar.
• Contoh Batasan: 1000 requests per menit.
• Respons 429: Jika melebihi batasan, Anda akan menerima respons 429 Too Many Requests. Untuk menghindari error ini, pertimbangkan mekanisme retry atau logika pengiriman ulang.
Tips untuk Penggunaan Optimal di Produksi:
• Caching Data yang Sering Digunakan: Mengurangi permintaan berulang untuk data yang tidak berubah sering kali membantu menghindari penggunaan rate limit yang berlebihan.
• Gunakan Retry Logic: Terapkan mekanisme retry dengan jeda waktu jika menerima respons 429 untuk memastikan kelancaran operasi.
• Pantau Penggunaan API: Gunakan log atau alat pemantauan untuk melacak penggunaan API secara real-time.
Mengelola dan Mengoptimalkan Rate Limit
1. Optimasi Permintaan: Hanya kirimkan permintaan yang benar-benar diperlukan dan gabungkan permintaan jika memungkinkan.
2. Gunakan Webhook untuk Notifikasi: Alih-alih mengandalkan polling data secara terus-menerus, gunakan fitur webhook Biteship untuk menerima notifikasi real-time saat ada perubahan status.
3. Konsultasi dengan Dukungan: Jika Anda sering menghadapi batasan rate limit, hubungi tim dukungan Biteship di support@biteship.com untuk berdiskusi tentang kebutuhan spesifik Anda.
Pertanyaan yang Sering Diajukan
• Apa yang Terjadi Jika Saya Melebihi Rate Limit?
Jika Anda melebihi rate limit, server akan mengembalikan respons 429 Too Many Requests. Tunggu beberapa saat sebelum mengirim ulang permintaan.
• Apakah Rate Limit Berbeda untuk Setiap Pengguna?
Rate limit dapat bervariasi tergantung pada jenis akun atau kebutuhan spesifik yang disepakati dengan Biteship.
• Bagaimana Saya Bisa Memantau Penggunaan API?
Anda dapat memantau penggunaan API melalui log permintaan di aplikasi Anda atau menggunakan alat pemantauan API pihak ketiga untuk analisis yang lebih mendalam.
Jika ada pertanyaan lebih lanjut, silakan hubungi support@biteship.com.