Referensi API
Semua endpoint memakai URL yang sama. Pilih kurir lewat field carrier (body atau query). Satu Bearer token untuk semua kurir yang didukung.
Overview
Base URL
http://localhost/api
Gunakan origin aplikasi yang sudah di-deploy sebagai base (mis. https://your-domain.com saat live, atau http://localhost:8000 saat development lokal).
Autentikasi
Authorization: Bearer <token>
Tipe konten
Content-Type: application/json
Selamat datang di Dokumentasi API EkspedisiKu. API ini memungkinkan pengembang, mitra, dan integrator sistem untuk mengakses layanan ekspedisi melalui satu gateway yang konsisten.
Dengan satu API key, Anda memakai endpoint yang sama (/api/rates, /api/shipments, /api/track/{id}) dan memilih kurir lewat field carrier atau query ?carrier=.
Parameter carrier
Nilai carrier yang didukung (booking & tracking). Rates mengembalikan semua kurir yang siap kecuali Anda filter di sisi client.
| carrier | Booking | Id tracking | API pickup |
|---|---|---|---|
| lion_parcel | origin, destination, package | STT / resi | Ya |
| lalamove | pickup/dropoff lat,lng + kontak | orderId | Tidak (on-demand) |
| jne, jnt | Segera hadir | ||
Fitur Utama
- Integrasi Mudah: Satu API key untuk semua kurir yang didukung.
- Response Seragam: Format hasil cek ongkir dan tracking dinormalisasi agar konsisten di tiap kurir.
- Aman: Autentikasi via Bearer token, throttling, dan pencatatan histori pemakaian service.
Tentang Dokumentasi
Panduan ini menyediakan informasi tentang:
- Endpoint API dan parameter
- Autentikasi dan format header
- Contoh permintaan (request) dan respons (response)
- Penanganan error
Konfigurasi server
Set kredensial kurir di server EkspedisiKu (.env). Client hanya mengirim Bearer token.
| Kurir | Variabel |
|---|---|
| lion_parcel | LION_API_URL, LION_CLIENT_ID, LION_CLIENT_SECRET, LION_WEBHOOK_SECRET |
| lalamove | LALAMOVE_API_URL, LALAMOVE_API_KEY, LALAMOVE_API_SECRET, LALAMOVE_MARKET, LALAMOVE_DEFAULT_SERVICE_TYPE |