Planing Consideration

Panduan ini membantu Anda memahami hal-hal penting dan praktik terbaik untuk memastikan integrasi Lion Parcel API berjalan aman, patuh regulasi, dan dapat berkembang sesuai kebutuhan bisnis Anda.

1. Kebutuhan Data untuk Setiap API

Setiap endpoint API Lion Parcel membutuhkan data tertentu agar proses berjalan dengan benar. Anda harus dapat mengirim dan menyimpan data berikut sesuai kebutuhan masing-masing API.

A. Rate API (Cek Tarif)

Data yang dibutuhkan: Origin, destination, berat, jenis layanan, panjang, lebar, tinggi Tujuan: Menghitung estimasi biaya kirim

B. Create Shipment (Pickup / Drop-off)

Data yang dibutuhkan: Origin, destination, data pengirim & penerima, alamat, geolokasi, berat, dimensi, COD/non-COD Tujuan: Membuat pengiriman baru

C. Request Pickup

Data yang dibutuhkan: Shipment ID, pickup start date, pickup end date Tujuan: Mengajukan permintaan pickup

D. Tracking (STT Tracking)

Data yang dibutuhkan: Nomor STT atau Shipment ID Tujuan: Mengambil status terbaru pengiriman

E. STT Detail

Data yang dibutuhkan: Nomor STT Tujuan: Mendapatkan detail lengkap pengiriman

F. STT Booking (Client Method , POS Method, CBP Method)

Data yang dibutuhkan: Origin, destination, data pengirim & penerima, alamat, berat, dimensi, COD/non-COD Tujuan: Membuat STT (waybill) untuk klien korporasi

G. Print STT

Data yang dibutuhkan: Nomor STT, parent client ID Tujuan: Menghasilkan label pengiriman resmi Lion Parcel

---

2. Pertimbangan Keamanan

Keamanan adalah prioritas utama dalam integrasi API. Pastikan setiap request dan respons memenuhi standar berikut:

• Gunakan HTTPS (TLS 1.2/1.3) untuk seluruh komunikasi

• Lakukan autentikasi menggunakan API Key atau Bearer Token yang valid

• Jangan menyimpan kredensial API di sisi frontend

• Terapkan IP whitelisting jika diminta Lion Parcel

• Enkripsi data sensitif (nomor telepon, alamat) sebelum disimpan

• Simpan audit log untuk semua request dan respons API

---

3. Kepatuhan & Regulasi

Integrasi harus mengikuti aturan hukum dan kebijakan privasi yang berlaku:

• Perlindungan Data Pribadi: Semua data pengguna harus mengikuti regulasi PDP

• Kerahasiaan Data: Data pelanggan tidak boleh dibagikan tanpa izin Lion Parcel

• Audit & Monitoring: Lion Parcel dapat melakukan audit untuk memastikan kepatuhan operasional dan keamanan

---

4. Skalabilitas

Lion Parcel API dirancang untuk kebutuhan skala besar. Untuk menjaga performa tetap optimal, kami menyarankan Anda:

• Menggunakan mekanisme asynchronous untuk beban transaksi tinggi

• Menggunakan webhook untuk pembaruan tracking real-time

• Menerapkan retry otomatis untuk kegagalan request sementara

• Menggunakan batching atau throttling sesuai rate limit Lion Parcel

• Melakukan caching internal agar mengurangi panggilan API berulang

---

5. Pemeliharaan Sistem

Lion Parcel API secara berkala menerima pembaruan. Untuk itu, pastikan bahwa Anda:

• Memantau perubahan versi API

• Mengikuti notifikasi pembaruan endpoint yang dikirim melalui email atau portal partner

• Menyesuaikan sistem Anda jika ada perubahan teknis