ওভারভিউ
অংশীদার ইকমার্স প্ল্যাটফর্ম সার্ভার থেকে Bearer API কী দিয়ে স্থানীয় বাংলাদেশ কুরিয়ার এবং আন্তর্জাতিক রুটের এস্টিমেট নিতে ও বুকিং কিউতে পাঠাতে পারে।
POST /api/v1/quotes— র্যাঙ্ক করা এস্টিমেট অপশনPOST /api/v1/shipments— ISL সিরিয়াল কিউতে বুকGET /api/v1/shipments/track?token=…— পাবলিক স্ট্যাটাস পোল
অথেনটিকেশন
অংশীদারিত্বের পর ISL একটি Marketplace API কী ইস্যু করে (Admin → Marketplace API)। সার্ভার সাইড সিক্রেটে সংরক্ষণ করুন; ব্রাউজার জাভাস্ক্রিপ্টে রাখবেন না।
Authorization: Bearer YOUR_KEY Idempotency-Key: store-checkout-abc
কী অনুরোধ করতে ইমেইল করুন: contact@islfreight.com
কোটেশন
POST /api/v1/quotes
Authorization: Bearer YOUR_KEY
Idempotency-Key: quote-1
Content-Type: application/json
{
"origin": "Dhanmondi, Dhaka",
"destination": "Agrabad, Chattogram",
"weight_kg": 1,
"length_cm": 20,
"width_cm": 15,
"height_cm": 10,
"service": "courier",
"delivery_mode": "home",
"cod_amount": 1000
}আবশ্যক: origin, destination, weight_kg। মাত্রা (length/width/height_cm) স্থানীয় কার্ড ম্যাচের জন্য সুপারিশকৃত।
বুকিং / সিরিয়াল কিউ
POST /api/v1/shipments
Authorization: Bearer YOUR_KEY
Idempotency-Key: order-123
Content-Type: application/json
{
"origin": "Dhanmondi, Dhaka",
"destination": "Agrabad, Chattogram",
"weight_kg": 1,
"length_cm": 20, "width_cm": 15, "height_cm": 10,
"service": "courier",
"customer_name": "Store customer",
"customer_phone": "01XXXXXXXXX"
}ISL সবচেয়ে সস্তা ম্যাচিং রেট দিয়ে পার্টনারদের র্যাঙ্ক করে এবং একজন করে অফার করে। Decline বা SLA টাইমআউটে পরবর্তী পার্টনারে যায়; accept করলে জব লক হয়।
স্থানীয় বনাম আন্তর্জাতিক
- local — BD কুরিয়ার লেন কার্ড (service courier/door/transport, BD রুট)।
- international — ভেন্ডর চার্ট সারি: দেশ, জিপ, ওজন, মাত্রা, CBM, মূল্য, ট্রানজিট, পণ্য, HS, VAT/ট্যাক্স। service air/sea/customs বা country/destination আন্তর্জাতিক হলে।
- ঐচ্ছিক
route_mode:local|international
জটিল সি/এয়ার RFQ এখনও POST /api/v1/rfqs.
কী ও সাপোর্ট
API কী শুধু অংশীদার স্টোরের জন্য। টেকনিক্যাল স্পেক: docs/API.md. যোগাযোগ: contact@islfreight.com