API Cek Ongkos Kirim Gratis — JNE, JNT, SiCepat, SAP, dan Lainnya
Hitung ongkos kirim antar kelurahan di seluruh Indonesia dengan API Cek Ongkir gratis kami. Dukungan 14+ ekspedisi populer termasuk JNE Express, JNT Express, SiCepat, SAP, dan lainnya. Dapatkan estimasi harga dan waktu pengiriman secara real-time.
API Cek Ongkir: Solusi Lengkap untuk Perhitungan Biaya Pengiriman
API Cek Ongkos Kirim (Expedition API) adalah layanan API yang memungkinkan Anda menghitung biaya pengiriman antar kelurahan di seluruh Indonesia. Dengan dukungan lebih dari 14 ekspedisi populer seperti JNE, JNT, SiCepat, SAP, iDexpress, Lion Parcel, AnterAja, dan Ninja Express, API ini menjadi solusi lengkap untuk integrasi perhitungan ongkir di aplikasi e-commerce, marketplace, atau sistem logistik Anda.
API ini dirancang dengan sistem caching otomatis untuk respons yang lebih cepat, mendukung perhitungan berbasis berat, dan menyediakan estimasi waktu pengiriman. Semua data ongkir diperbarui secara berkala untuk memastikan akurasi harga yang selalu terkini.
🚚 Ekspedisi yang Didukung
14+ Ekspedisi
Dukungan lengkap untuk JNE, JNT, SiCepat, SAP, iDexpress, dan ekspedisi populer lainnya.
Cepat & Caching
Respons cepat dengan sistem caching otomatis untuk performa optimal.
Berbasis Berat
Perhitungan ongkir akurat berdasarkan berat paket dalam kilogram.
Estimasi Waktu
Dapatkan estimasi waktu pengiriman untuk setiap layanan ekspedisi.
📍 Kode Kelurahan (Village Code)
Untuk menggunakan API ini, Anda memerlukan kode kelurahan (village_code) yang terdiri dari 10 digit. Kode kelurahan dapat Anda dapatkan melalui API Wilayah Indonesia. Gunakan endpoint /regional/indonesia/villages untuk mencari kelurahan dan mendapatkan kode 10 digit yang diperlukan untuk perhitungan ongkir.
Dokumentasi API Cek Ongkir
Endpoint REST yang jelas untuk perhitungan biaya pengiriman antar kelurahan di Indonesia. Pelajari cara menggunakan layanan ini dengan mudah.
🔐 Authentication: Semua request memerlukan header x-api-co-id dengan API key Anda. Dapatkan API key gratis di dashboard.
{{base-url}}/expedition/shipping-cost
Hitung biaya pengiriman dari kelurahan asal ke kelurahan tujuan. Endpoint ini mengembalikan daftar semua ekspedisi yang tersedia beserta harga dan estimasi waktu pengiriman. Hanya ekspedisi dengan harga lebih dari 0 yang dikembalikan.
Query Parameters (Required):
origin_village_code– Kode kelurahan asal (10 digit). Dapatkan dari API Wilayah Indonesiadestination_village_code– Kode kelurahan tujuan (10 digit). Dapatkan dari API Wilayah Indonesiaweight– Berat paket dalam kilogram (harus lebih besar dari 0)
GET https://use.api.co.id/expedition/shipping-cost?origin_village_code=3172051003&destination_village_code=3204402005&weight=1
Headers:
x-api-co-id: YOUR_API_KEY
{
"is_success": true,
"message": "Success",
"data": {
"origin_village_code": "3172051003",
"destination_village_code": "3204402005",
"weight": 1,
"couriers": [
{
"courier_code": "JNE",
"courier_name": "JNE Express",
"price": 8000,
"weight": 1,
"estimation": "2 - 3 days"
},
{
"courier_code": "JNECargo",
"courier_name": "JNE Cargo",
"price": 55000,
"weight": 1,
"estimation": "2 - 3 days"
},
{
"courier_code": "SAP",
"courier_name": "SAP Express",
"price": 12000,
"weight": 1,
"estimation": "3 - 5 days"
},
{
"courier_code": "JT",
"courier_name": "J&T Express",
"price": 13000,
"weight": 1,
"estimation": null
}
]
}
}
Error Responses:
- 400 Bad Request: Parameter wajib tidak lengkap atau berat kurang dari atau sama dengan 0
- 404 Not Found: Kode kelurahan tidak ditemukan dalam database
- 400 Bad Request: Kelurahan belum didukung (belum memiliki courier_id). Silakan buka tiket untuk mengaktifkan kelurahan tersebut
{
"is_success": false,
"message": "origin_village_code is required"
}
{
"is_success": false,
"message": "weight must be greater than 0"
}
{
"is_success": false,
"message": "Origin village code '9999999999' does not exist. Please find valid village codes at https://api.co.id/indonesia-regional-api/"
}
{
"is_success": false,
"message": "This village was not supported yet, please open ticket to activate this village"
}
Lihat Dokumentasi Lengkap
Lihat skema lengkap, header, batasan, dan explorer interaktif di dokumentasi resmi kami.
Pertanyaan Umum tentang API Cek Ongkir
Temukan jawaban untuk pertanyaan umum seputar API cek ongkir, penggunaan, dan integrasi.
Apa itu API Cek Ongkir?
API Cek Ongkir (Expedition API) adalah layanan API yang memungkinkan Anda menghitung biaya pengiriman antar kelurahan di seluruh Indonesia. API ini mendukung lebih dari 14 ekspedisi populer seperti JNE Express, JNE Cargo, J&T Express, SiCepat Express, SiCepat Cargo, SAP Express, SAP Lite, SAP Cargo, iDexpress, iDlite, Lion Parcel, iDexpress Cargo, AnterAja, dan Ninja Express. API ini dirancang untuk integrasi mudah di aplikasi e-commerce, marketplace, atau sistem logistik Anda.
Bagaimana cara menggunakan API Cek Ongkir?
Untuk menggunakan API ini, Anda perlu mendaftar dan mendapatkan API key terlebih dahulu di dashboard. Setelah mendapatkan API key, sertakan dalam header request sebagai x-api-co-id: YOUR_API_KEY. Anda juga memerlukan kode kelurahan (village_code) 10 digit untuk asal dan tujuan, yang dapat Anda dapatkan melalui API Wilayah Indonesia. Kirim request ke endpoint /expedition/shipping-cost dengan parameter origin_village_code, destination_village_code, dan weight.
Bagaimana cara mendapatkan kode kelurahan (village_code)?
Kode kelurahan (village_code) yang terdiri dari 10 digit dapat Anda dapatkan melalui API Wilayah Indonesia. Gunakan endpoint /regional/indonesia/villages untuk mencari kelurahan berdasarkan nama atau filter lainnya. Setiap kelurahan memiliki kode unik 10 digit yang diperlukan untuk perhitungan ongkir. Pastikan kedua kelurahan (asal dan tujuan) memiliki kode yang valid dan sudah didukung oleh sistem ekspedisi.
Ekspedisi apa saja yang didukung?
API ini mendukung lebih dari 14 ekspedisi populer di Indonesia, termasuk: JNE Express, JNE Cargo, SiCepat Express, SiCepat Cargo, SAP Express, SAP Lite, SAP Cargo, iDexpress, iDlite, J&T Express, Lion Parcel, iDexpress Cargo, AnterAja, dan Ninja Express. Setiap request akan mengembalikan semua ekspedisi yang tersedia untuk rute tersebut, dengan harga dan estimasi waktu pengiriman.
Apa yang terjadi jika kelurahan belum didukung?
Jika kelurahan yang Anda gunakan belum memiliki courier_id yang diperlukan, API akan mengembalikan error dengan pesan “This village was not supported yet, please open ticket to activate this village”. Dalam hal ini, Anda dapat membuka tiket melalui dashboard atau menghubungi support untuk mengaktifkan kelurahan tersebut. Tim kami akan segera memproses permintaan Anda.
Bagaimana format response API?
Response API mengembalikan format JSON dengan struktur konsisten: is_success (boolean), message (string), dan data (object). Data berisi origin_village_code, destination_village_code, weight, dan array couriers. Setiap item dalam array couriers berisi courier_code, courier_name, price (dalam Rupiah), weight, dan estimation (estimasi waktu pengiriman). Hanya ekspedisi dengan harga lebih dari 0 yang dikembalikan.
Berapa berat minimum yang didukung?
Parameter weight harus lebih besar dari 0 (dalam kilogram). Tidak ada batas maksimum, namun pastikan berat yang Anda masukkan sesuai dengan berat aktual paket. Perhitungan ongkir akan disesuaikan dengan berat yang Anda berikan. Untuk akurasi yang lebih baik, gunakan berat yang tepat dari paket yang akan dikirim.
Apakah estimasi waktu pengiriman selalu tersedia?
Tidak selalu. Beberapa ekspedisi menyediakan estimasi waktu pengiriman, sementara yang lain mungkin mengembalikan null untuk field estimation. Ini tergantung pada data yang tersedia dari masing-masing ekspedisi. Jika estimasi tersedia, akan ditampilkan dalam format seperti “2 – 3 days” atau “3 – 5 days”. Jika tidak tersedia, field akan berisi null.
Mulai Gunakan API Cek Ongkir Sekarang
Integrasikan perhitungan ongkir ke aplikasi Anda dengan mudah. Dapatkan API key gratis dan mulai hitung biaya pengiriman untuk 14+ ekspedisi populer di Indonesia.
