API Cek Ongkir Indonesia: Panduan Lengkap AgenWebsite Rate API
AgenWebsite Rate API adalah REST API cek ongkir untuk developer yang membutuhkan tarif pengiriman real-time dari kurir Indonesia. Dengan satu endpoint POST /v1/rates, Anda bisa mendapatkan ongkos kirim dari JNE, J&T Express, SiCepat, POS Indonesia, AnterAja, TIKI, Paxel, GoSend, Lion Parcel, SPX, J&T Cargo, dan kurir lainnya sekaligus — tanpa harus melakukan integrasi terpisah untuk masing-masing kurir. API ini dirancang untuk toko online WooCommerce, aplikasi Laravel, backend Node.js, maupun platform e-commerce custom.
Apa itu API cek ongkir dan mengapa penting?
API cek ongkir adalah layanan yang memungkinkan aplikasi Anda menghitung biaya pengiriman secara otomatis berdasarkan titik asal, titik tujuan, dan berat paket. Tanpa API, pemilik toko harus menghitung ongkir manual untuk setiap pesanan — proses yang lambat, rentan salah, dan tidak scalable. Dengan AgenWebsite Rate API, tarif dihitung real-time langsung dari jaringan kurir dan ditampilkan di checkout dalam hitungan milidetik, meningkatkan kepercayaan pembeli dan menurunkan angka pembatalan pesanan.
Bagaimana cara mendapatkan API key AgenWebsite?
Untuk mendapatkan API key gratis: (1) daftar akun di agenwebsite.com, (2) buka menu My Account > API, (3) verifikasi email satu kali, lalu (4) klik Generate Key. API key berformat awk_live_xxxxxxxx akan langsung aktif dengan tier Free 150 request per hari, tanpa kartu kredit. Setiap request cukup menyertakan header x-api-key. Berikut contoh request paling sederhana:
curl -X POST https://api.agenwebsite.com/v1/rates \
-H "x-api-key: awk_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"shipper": { "postal_code": "40135" },
"destination": { "postal_code": "10110" },
"weight": 1000,
"couriers": ["jnt", "lion"]
}'Cek ongkir berbasis kode pos vs kecamatan — mana lebih akurat?
AgenWebsite Rate API berbasis kode pos untuk akurasi maksimal, namun tetap mendukung input kecamatan. Anda bisa mengirim postal_code langsung, atau memakai subdistrict_id yang diperoleh dari endpoint /v1/locations/search. Karena sistem kurir di Indonesia menghitung tarif berdasarkan zona kode pos, memakai kode pos menghasilkan perhitungan yang lebih presisi dibanding hanya mengandalkan nama kecamatan yang bisa ambigu.
Berapa harga dan kuota API shipping rate?
Tersedia tiga tier: Free (gratis, 150 request/hari), Pro (Rp 129.000/bulan, 30.000 request/hari), dan Max (Rp 229.000/bulan, 60.000 request/hari). Kuota dihitung per request — bukan per baris kurir — sehingga satu panggilan yang mengembalikan banyak kurir tetap dihitung sebagai satu request. Kuota direset setiap hari pukul 00:00 WIB. Jika kuota atau burst limit terlampaui, API mengembalikan HTTP 429 dengan header Retry-After sehingga aplikasi Anda bisa menanganinya dengan graceful.
Cara integrasi API ongkir ke WooCommerce, Laravel, dan Node.js
Integrasi sangat sederhana karena AgenWebsite Rate API adalah REST API standar berbasis JSON. Di WooCommerce/WordPress gunakan wp_remote_post, di Node.js gunakan fetch atau axios, dan di Laravel gunakan HTTP client bawaan (Http::withHeaders). Karena response sudah ternormalisasi, Anda tidak perlu menulis parser berbeda untuk tiap kurir — cukup baca array data.rates dan tampilkan cost, etd_text, discount, dan cashback ke pengguna Anda.
Asuransi via API ongkir
AgenWebsite Rate API mendukung perhitungan asuransi pengiriman. Kirim item_value (nilai barang dalam IDR) pada body request, dan response akan menyertakan objek insurance dengan field available dan fee untuk setiap layanan. Ini memudahkan Anda menampilkan biaya asuransi secara akurat tanpa asumsi manual. Catatan: Rate API v1 adalah pengiriman reguler dan non-COD — COD belum tersedia melalui API pada versi ini.
Menampilkan tarif termurah dan tercepat otomatis di checkout
Setiap response menandai layanan termurah (cheapest) dan tercepat (fastest), serta menyertakan objek ringkasan cost_range. Dengan parameter sort Anda bahkan bisa meminta hasil terurut berdasarkan harga atau kecepatan. Ini memungkinkan Anda menampilkan rekomendasi "Termurah" dan "Tercepat" secara otomatis di halaman checkout, sebuah pola UX yang terbukti meningkatkan konversi.
Rate limiting dan kuota: best practice untuk toko volume tinggi
Untuk toko dengan trafik tinggi, terapkan caching di sisi Anda dengan memanfaatkan kombinasi asal-tujuan-berat sebagai cache key, hormati header X-RateLimit-Remaining dan Retry-After, serta gunakan endpoint /v1/usage untuk memantau konsumsi kuota harian. Bila mendekati batas, upgrade ke tier Pro atau Max yang menyediakan hingga 60.000 request per hari dan burst 600 request per menit.