Zeo API และ Webhooks

แพลตฟอร์มสำหรับนักพัฒนา คุณสมบัติ

ทุกสิ่งที่คุณต้องการเพื่อผสานการวางแผนเส้นทางเข้ากับแอปพลิเคชันของคุณ

เริ่มต้นได้ฟรี

REST API

API RESTful ที่ครบครันสำหรับการจัดการเส้นทาง จุดจอด คนขับ และอื่นๆ รูปแบบการร้องขอ/ตอบกลับ JSON พร้อมเอกสารประกอบอย่างละเอียด
- สร้างและปรับแต่งเส้นทางโดยอัตโนมัติ
- จัดการจุดจอด พนักงานขับรถ และยานพาหนะ
- ดึงข้อมูลการติดตามแบบเรียลไทม์
- เข้าถึงข้อมูลวิเคราะห์และรายงาน
- การสนับสนุนการดำเนินงานจำนวนมาก
กิจกรรมเว็บฮุก

การแจ้งเตือนเหตุการณ์แบบเรียลไทม์จะถูกส่งไปยังอุปกรณ์ปลายทางของคุณ ตอบสนองต่อการเปลี่ยนแปลงเส้นทาง การหยุดรถ และการอัปเดตข้อมูลคนขับได้ทันที
- กิจกรรมเริ่มต้น/เสร็จสิ้นเส้นทาง
- หยุดการแจ้งเตือนการเปลี่ยนแปลงสถานะ
- การอัปเดตตำแหน่งคนขับ
- การแจ้งเตือนการเปลี่ยนแปลงเวลาถึงโดยประมาณ
การยืนยันตัวตน

การเข้าถึง API ที่ปลอดภัยด้วยการตรวจสอบสิทธิ์ตามมาตรฐานอุตสาหกรรม มีประเภทคีย์หลายประเภทสำหรับระดับการเข้าถึงและกรณีการใช้งานที่แตกต่างกัน
- การตรวจสอบสิทธิ์ด้วยโทเค็น Bearer
- แดชบอร์ดการจัดการคีย์ API
- สิทธิ์การเข้าถึงแบบจำกัดต่อคีย์
- การรองรับการหมุนกุญแจ
- การจำกัดอัตราการใช้ต่อคีย์
การนำเข้าจากบุคคลที่สาม

นำเข้าคำสั่งซื้อและงานจากระบบภายนอกได้อย่างราบรื่น พร้อมระบบตรวจสอบที่อยู่และระบุพิกัดทางภูมิศาสตร์อัตโนมัติเมื่อนำเข้า
- จุดสิ้นสุดการหยุดการนำเข้าจำนวนมาก
- การตรวจสอบที่อยู่และการระบุพิกัดทางภูมิศาสตร์
- การแมปฟิลด์แบบกำหนดเอง
- การตรวจจับซ้ำ
- การติดตามสถานะการนำเข้า

webhook อีเวนต์

ติดตามเหตุการณ์แบบเรียลไทม์และตอบสนองต่อการเปลี่ยนแปลงเส้นทางได้ทันที

เฟรม 1707478314 20 1, โปรแกรมวางแผนเส้นทาง Zeo

เส้นทางเริ่มต้น

สัญญาณเตือนนี้จะถูกเรียกใช้เมื่อคนขับเริ่มนำทางตามเส้นทาง โดยจะแสดงรหัสเส้นทาง ข้อมูลคนขับ และเวลาที่คาดว่าจะแล้วเสร็จ

เฟรม 1707478314 19, ผู้วางแผนเส้นทาง Zeo

หยุดเสร็จสมบูรณ์

แอปจะทำงานเมื่อการหยุดรถเสร็จสมบูรณ์แล้ว โดยจะมีข้อมูลหลักฐานการให้บริการ เวลา และหมายเหตุประกอบอยู่ด้วย

เฟรม 1707478314 17, ผู้วางแผนเส้นทาง Zeo

หยุดล้มเหลว

ส่งข้อความนี้เมื่อไม่สามารถทำการหยุดรถได้สำเร็จ โดยจะระบุเหตุผลที่ล้มเหลวและภาพถ่าย/บันทึกใดๆ ที่บันทึกไว้

อัปเดตตำแหน่งคนขับ

การอัปเดตตำแหน่งที่ตั้งเป็นระยะสำหรับผู้ขับขี่ที่ใช้งานอยู่ สามารถกำหนดความถี่ได้ตั้งแต่ 30 วินาทีถึง 5 นาที

eta.changed

สัญญาณเตือนจะดังขึ้นเมื่อเวลาที่คาดว่าจะมาถึงเปลี่ยนแปลงอย่างมีนัยสำคัญเนื่องจากสภาพการจราจรหรือความล่าช้า

เส้นทางเสร็จสมบูรณ์

จะทำงานเมื่อการหยุดทั้งหมดเสร็จสิ้นแล้ว รวมถึงสถิติสุดท้าย ระยะเวลา และตัวชี้วัดประสิทธิภาพ

// ตัวอย่างข้อมูลเพย์โหลดของเว็บฮุค
{
  "เหตุการณ์": "หยุดเสร็จสมบูรณ์",
  "การประทับเวลา": "2024-01-15T14:32:00Z",
  "ข้อมูล"{
    "รหัสเส้นทาง": "เส้นทาง_abc123",
    "รหัสหยุด": "หยุด_xyz789",
    "คนขับ"{
      "id": "drv_456",
      "ชื่อ": "จอห์น สมิธ"
    },
    "เสร็จสมบูรณ์เมื่อ": "2024-01-15T14:31:45Z",
    "การพิสูจน์"{
      "ลายเซ็น": "https://...",
      "รูปถ่าย": ["https://..."],
      "บันทึก": "วางไว้ที่ประตู"
    -

จุดสิ้นสุด API ภาพรวมสินค้า

จุดเชื่อมต่อหลักสำหรับการวางแผนเส้นทางและการจัดการยานพาหนะ

POST

/v1/เส้นทาง

สร้างเส้นทางใหม่พร้อมจุดจอดและตั้งค่าการเพิ่มประสิทธิภาพ

GET

/v1/routes/{id}

เรียกดูรายละเอียดเส้นทาง รวมถึงลำดับที่เหมาะสมที่สุด

POST

/v1/routes/{id}/optimize

ปรับปรุงเส้นทางที่มีอยู่ให้เหมาะสมยิ่งขึ้นด้วยพารามิเตอร์ที่อัปเดตแล้ว

GET

/v1/routes/{id}/tracking

รับข้อมูลการติดตามแบบเรียลไทม์สำหรับเส้นทางที่ใช้งานอยู่

POST

/v1/stops/import

การนำเข้าข้อมูลจำนวนมากจะหยุดลงจากระบบภายนอก

PUT

/v1/stops/{id}/status

อัปเดตสถานะการหยุด (เสร็จสมบูรณ์ ล้มเหลว ข้าม)

GET

/v1/ไดรเวอร์

แสดงรายชื่อพนักงานขับรถทั้งหมดพร้อมสถานะความพร้อมให้บริการ

GET

/v1/drivers/{id}/location

ตรวจสอบตำแหน่งปัจจุบันและความคืบหน้าของเส้นทาง

POST

/v1/webhooks

ลงทะเบียนเอนด์พอยต์เว็บฮุคสำหรับการแจ้งเตือนเหตุการณ์

รหัส ตัวอย่าง

เริ่มต้นใช้งานได้อย่างรวดเร็วด้วยตัวอย่างในภาษาที่คุณชื่นชอบ

// สร้างและปรับเส้นทางที่มีจุดจอดหลายจุดให้เหมาะสมที่สุด
const สร้างเส้นทาง = async -
  const การตอบสนอง = รอคอย ดึงข้อมูล('https://api.zeoroute.com/v1/routes', { วิธี: 'โพสต์'ส่วนหัว: {
      ‘การอนุญาต’: `Bearer ${process.env.ZEO_API_KEY}`,
      'ประเภทเนื้อหา': 'แอปพลิเคชัน/json'
    }, เนื้อหา: JSON.stringify({ ชื่อ: 'บริการส่งของตอนเช้า', รหัสคนขับ: 'drv_123'ปรับให้เหมาะสม: จริง, ตำแหน่งเริ่มต้น: { ที่อยู่: '123 ถนนโกดัง เมือง'
      }, หยุด: [ { ที่อยู่: '456 ถนนลูกค้า', ช่วงเวลา: { เริ่ม: '09:00', จบ: '12:00' }, เวลาให้บริการ: 15
        }, { ที่อยู่: '789 บิสซิเนส บูเลอวาร์ด', ลำดับความสำคัญ: 'สูง'เวลาให้บริการ: 30
        -

  const เส้นทาง = รอคอย response.json(); console.log('เส้นทางที่เหมาะสมที่สุด:'เส้นทาง.ลำดับที่ปรับให้เหมาะสม);
  กลับ เส้นทาง; };

# สร้างและปรับเส้นทางที่มีจุดจอดหลายจุดให้เหมาะสมที่สุด
นำเข้า การร้องขอ
นำเข้า os API_KEY = os.environ.get('ZEO_API_KEY') BASE_URL = 'https://api.zeoroute.com/v1'

ส่วนหัว = {
    ‘การอนุญาต’: ผู้ถือ {API_KEY}',
    'ประเภทเนื้อหา': 'แอปพลิเคชัน/json'
} route_data = {
    'ชื่อ': 'บริการส่งของตอนเช้า',
    'driver_id': 'drv_123',
    'ปรับให้เหมาะสม': จริง,
    'ตำแหน่งเริ่มต้น'{
        'ที่อยู่': '123 ถนนโกดัง เมือง'
    },
    'หยุด'-
            'ที่อยู่': '456 ถนนลูกค้า',
            'ช่วงเวลา'{'เริ่ม': '09:00', 'จบ': '12:00'},
            'เวลาให้บริการ': 15
        -
            'ที่อยู่': '789 บิสซิเนส บูเลอวาร์ด',
            'ลำดับความสำคัญ': 'สูง',
            'เวลาให้บริการ': 30
        } ] } response = requests.post(
    f'{BASE_URL}/เส้นทาง, headers=headers, json=route_data ) route = response.json() print('เส้นทางที่เหมาะสมที่สุด:', เส้นทาง['ลำดับที่ปรับให้เหมาะสม'])

# สร้างและปรับเส้นทางที่มีจุดจอดหลายจุดให้เหมาะสมที่สุด
ขด -X โพสต์ "https://api.zeoroute.com/v1/routes" \ -ชม "การอนุญาต: ผู้ถือ $ZEO_API_KEY" \ -ชม "Content-Type: application/json" -d '{ "name": "Morning Deliveries", "driver_id": "drv_123", "optimize": true, "start_location": { "address": "123 Warehouse St, City" }, "stops": [ { "address": "456 Customer Ave", "time_window": {"start": "09:00", "end": "12:00"}, "service_time": 15 }, { "address": "789 Business Blvd", "priority": "high", "service_time": 30 } ] }'

# รับรายละเอียดเส้นทาง
curl -X GET "https://api.zeoroute.com/v1/routes/route_abc123" \ -ชม "การอนุญาต: ผู้ถือ $ZEO_API_KEY"

# อัปเดตสถานะการหยุด
ขด -X PUT "https://api.zeoroute.com/v1/stops/stop_xyz789/status" \ -ชม "การอนุญาต: ผู้ถือ $ZEO_API_KEY" \ -ชม "Content-Type: application/json" -d '{"สถานะ": "เสร็จสมบูรณ์", "หมายเหตุ": "วางไว้ที่ประตู"}'

บูรณาการ ใช้กรณี

การอัปเดตอัตโนมัติเหมาะสำหรับทุกอุตสาหกรรมที่มีการกำหนดเวลาการเข้าชม

การจัดส่ง

การผสานรวมการจัดการคำสั่งซื้อ

แพลตฟอร์มอีคอมเมิร์ซจะนำเข้าคำสั่งซื้อใหม่โดยอัตโนมัติผ่าน API ทุกชั่วโมง คำสั่งซื้อจะถูกจัดกลุ่มตามภูมิภาค ปรับเส้นทางการจัดส่งให้เหมาะสม และส่งไปยังคนขับ การแจ้งเตือนผ่าน Webhook จะอัปเดตสถานะคำสั่งซื้อแบบเรียลไทม์เมื่อการจัดส่งเสร็จสมบูรณ์

บริการภาคสนาม

การจัดตารางบริการโดยใช้ CRM

บริษัทให้บริการภาคสนามซิงค์ใบสั่งงานจากระบบ CRM ผ่าน API งานใหม่จะสร้างจุดแวะพักพร้อมรายละเอียดลูกค้า ข้อกำหนดการบริการ และช่วงเวลาโดยอัตโนมัติ เว็บฮุคเมื่อเสร็จสิ้นจะอัปเดตข้อมูลใน CRM และเริ่มการออกใบแจ้งหนี้