Skip to main content
หน้าหลักบล็อกคู่มือเวิร์กโฟลว์ API สำหรับติดตามการจัดส่ง: ตั้งแต่การลงทะเบียนการจัดส่งไปจนถึงการเรียกดูรายละเอียดการติดตาม

เวิร์กโฟลว์ API สำหรับติดตามการจัดส่ง: ตั้งแต่การลงทะเบียนการจัดส่งไปจนถึงการเรียกดูรายละเอียดการติดตาม

17TRACK

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

เวิร์กโฟลว์ API สำหรับติดตามการจัดส่งตั้งแต่การลงทะเบียนจนถึงการดึงข้อมูล

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

ทำความเข้าใจว่าการลงทะเบียนทำอะไรได้บ้างและทำอะไรไม่ได้

การลงทะเบียนการจัดส่งกับบริการติดตามหมายถึงการส่งตัวระบุเพื่อให้บริการสามารถติดตามหรือจัดการการจัดส่งนั้นตามสัญญา API การดำเนินการนี้ไม่ใช่การซื้อค่าจัดส่ง การสร้างใบจ่าหน้าสำหรับการจัดส่ง การจองให้เข้ารับพัสดุ หรือการส่งมอบพัสดุให้ผู้ให้บริการขนส่ง

ในแอปพลิเคชันของคุณควรแยกผลลัพธ์สามประเภทออกจากกัน:

  • ได้รับคำขอแล้ว: API ส่งการตอบกลับสำหรับคำขอ HTTP ของคุณ
  • ยอมรับการลงทะเบียนแล้ว: บริการยอมรับระเบียนการติดตามแต่ละรายการเพื่อประมวลผล
  • ข้อมูลการติดตามพร้อมใช้งาน: บริการมีข้อมูลการจัดส่งที่แอปพลิเคชันของคุณสามารถดึงหรือรับได้

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

1. เตรียมตัวตนของการจัดส่งและการกำหนดค่า API

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

ระเบียนภายในที่มีประโยชน์ประกอบด้วยข้อมูลต่อไปนี้ ฟิลด์เหล่านี้เป็นข้อเสนอแนะสำหรับแอปพลิเคชัน ไม่ใช่สคีมาคำขอของ 17TRACK

  • รหัสการจัดส่งภายใน: ตัวระบุที่คงที่ของคุณสำหรับพัสดุ
  • ข้อมูลอ้างอิงคำสั่งซื้อ: คำสั่งซื้อหรือระเบียนการจัดส่งสินค้าที่พัสดุนั้นสังกัด
  • หมายเลขติดตาม: ตัวระบุที่ผู้ให้บริการขนส่งออกให้ จัดเก็บเป็นข้อความเพื่อรักษาเลขศูนย์นำหน้า
  • ข้อมูลผู้ให้บริการขนส่ง: ตัวตนของผู้ให้บริการขนส่งที่ระบบจัดส่งสินค้าของคุณระบุ หากทราบ
  • ข้อมูลอ้างอิงของผู้ให้บริการ: ตัวระบุใด ๆ ที่บริการติดตามส่งกลับและจำเป็นสำหรับการดำเนินการภายหลัง
  • สถานะการลงทะเบียน: ระเบียนของคุณว่าการส่งอยู่ระหว่างรอดำเนินการ ยอมรับ ปฏิเสธ หรือรอการตรวจสอบผล
  • สถานะการติดตาม: สถานะล่าสุดของการจัดส่ง ซึ่งดูแลแยกจากสถานะการลงทะเบียน

ตรวจสอบอินพุตก่อนส่ง ลบช่องว่างโดยไม่ตั้งใจที่อยู่รอบค่า แต่ห้ามเขียนหมายเลขติดตามใหม่โดยอาศัยสมมติฐานเกี่ยวกับรูปแบบของผู้ให้บริการขนส่ง เก็บค่าต้นฉบับไว้เพื่อการแก้ไขปัญหา หากทราบผู้ให้บริการขนส่ง ให้แมปเป็นตัวระบุผู้ให้บริการที่ระบุไว้ในเอกสารของผู้ให้บริการ แทนการส่งชื่อที่ใช้แสดงแบบไม่เป็นทางการ

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

2. ลงทะเบียนการจัดส่งและบันทึกผลลัพธ์ระดับรายการ

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

โค้ดเทียมต่อไปนี้แสดงลำดับการทำงานของแอปพลิเคชัน ชื่อฟังก์ชันเป็นเพียงตัวอย่าง ไม่ใช่เอนด์พอยต์ API หรือเมธอด SDK

shipment = load_internal_shipment(shipment_id)
validate_tracking_input(shipment)

result = tracking_adapter.register(shipment)

if result.item_accepted:
    save_registration_result(shipment_id, result)
elif result.outcome_unknown:
    schedule_registration_reconciliation(shipment_id)
else:
    save_registration_error(shipment_id, result)
    route_for_retry_or_correction(result)

บันทึกข้อมูลให้เพียงพอที่จะอธิบายสิ่งที่เกิดขึ้น ได้แก่ รหัสการจัดส่งภายใน เวลาที่ส่ง หมายเลขครั้งที่พยายาม ผลลัพธ์ระดับรายการ และข้อมูลอ้างอิงคำขอของผู้ให้บริการ อย่าพึ่งพาเพียงล็อกชั่วคราวของ worker ทีมบริการลูกค้าและทีมปฏิบัติการต้องการคำตอบที่คงอยู่ถาวรว่าการจัดส่งได้รับการลงทะเบียนสำเร็จหรือไม่

จัดการการส่งแบบกลุ่มเป็นรายรายการ

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

วิธีนี้ป้องกันไม่ให้หมายเลขติดตามที่มีรูปแบบผิดเพียงรายการเดียวทำให้ต้องส่งซ้ำรายการที่สำเร็จแล้วโดยไม่จำเป็น และยังช่วยให้เจ้าหน้าที่ปฏิบัติการมีรายการที่แก้ไขได้อย่างชัดเจน

ถือว่าการหมดเวลาเป็นผลลัพธ์ที่ไม่ทราบแน่ชัด

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

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

3. รอให้ข้อมูลการติดตามแรกมาถึง

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

แสดงเงื่อนไขนี้อย่างชัดเจน “ลงทะเบียนแล้ว; รอข้อมูลการติดตาม” ถูกต้องกว่า “อยู่ระหว่างการขนส่ง” หรือ “การลงทะเบียนล้มเหลว” อย่าสร้างค่าประมาณการจัดส่งหรือเหตุการณ์การเคลื่อนย้ายขึ้นมาเพื่อเติมหน้าจอที่ว่างเปล่า

เมื่อระเบียนยังว่าง ให้ตรวจสอบตามลำดับที่เหมาะสม:

  1. ยืนยันว่าการลงทะเบียนรายการนั้นได้รับการยอมรับ
  2. เปรียบเทียบหมายเลขติดตามที่ส่งกับระเบียนการจัดส่งสินค้า
  3. ตรวจสอบการแมปผู้ให้บริการขนส่งและข้อกำหนดการค้นหาเพิ่มเติมที่ระบุไว้
  4. ตรวจสอบหน้าติดตามของผู้ให้บริการขนส่งสำหรับการจัดส่งเดียวกัน
  5. หากผู้ให้บริการมีเหตุการณ์แต่การเชื่อมต่อของคุณไม่มี ให้ตรวจสอบการตอบกลับจากการดึงข้อมูลและติดต่อผู้ให้บริการ API พร้อมข้อมูลวินิจฉัยที่ปกปิดข้อมูลสำคัญแล้ว

หลีกเลี่ยงการกำหนดระยะเวลารอแบบสากลโดยไม่มีหลักฐาน กฎการยกระดับปัญหาควรสะท้อนบริการขนส่ง กระบวนการส่งมอบที่คาดไว้ และพันธะด้านการปฏิบัติงานของคุณ

4. ดึงรายละเอียดการติดตามและตีความอย่างถูกต้อง

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

แอปพลิเคชันควรแยกข้อมูลสามระดับ:

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

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

แยกเวลาของเหตุการณ์ออกจากเวลาการดึงข้อมูล

จัดเก็บเวลาที่เกี่ยวข้องกับเหตุการณ์ของผู้ให้บริการขนส่งแยกจากเวลาที่ระบบของคุณได้รับข้อมูล เหตุการณ์ที่ดึงข้อมูลในบ่ายวันนี้อาจอธิบายการสแกนที่เกิดขึ้นก่อนหน้านั้น หากแทนที่เวลาเหตุการณ์ด้วยเวลาการดึงข้อมูล การอัปเดตเก่าจะดูเหมือนการเคลื่อนย้ายทางกายภาพครั้งใหม่

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

รักษาความหมายดิบควบคู่กับสถานะมาตรฐาน

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

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

5. อัปเดตระเบียนผ่านการโพลหรือเว็บฮุก

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

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

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

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

การเชื่อมต่อที่ใช้เว็บฮุกเป็นหลักยังสามารถใช้การดึงข้อมูลแบบควบคุมเพื่อกระทบยอดได้ เช่น งานกู้คืนอาจตรวจสอบระเบียนที่ได้รับผลกระทบจากระบบตัวรับหยุดทำงาน นี่เป็นรูปแบบความทนทาน ไม่ใช่การอนุญาตให้ละเลยข้อจำกัดอัตราการเรียกหรือคำแนะนำเฉพาะของผู้ให้บริการ

6. เปลี่ยนข้อมูลการติดตามให้เป็นการดำเนินการทางธุรกิจที่ปลอดภัย

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

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

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

การนำเวิร์กโฟลว์ไปใช้กับการเชื่อมต่อ 17TRACK

สำหรับการเชื่อมต่อระบบติดตามแบบกำหนดเอง จุดเริ่มต้นที่เกี่ยวข้องคือ หน้า 17TRACK Tracking API และ เอกสารสำหรับนักพัฒนา ใช้หน้าผลิตภัณฑ์เพื่อประเมินข้อเสนอ และใช้เอกสารเพื่อกำหนดสัญญาการเชื่อมต่อจริง หน้าติดตามสำหรับผู้บริโภคไม่ใช่สิ่งทดแทนข้อกำหนด API

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

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

การตรวจสอบก่อนเปิดใช้งานที่ช่วยป้องกันข้อผิดพลาดราคาแพง

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

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

คำถามที่พบบ่อย

การลงทะเบียนหมายเลขติดตามสร้างการจัดส่งหรือไม่

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

เหตุใดรายละเอียดการติดตามจึงว่างหลังจากลงทะเบียนสำเร็จ

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

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

อย่าใช้การลงทะเบียนซ้ำเป็นกลไกรีเฟรชเริ่มต้น เก็บสถานะการลงทะเบียนที่ยอมรับแล้ว และใช้กลไกการดึงหรืออัปเดตตามเอกสาร ปฏิบัติตามกฎที่ชัดเจนของผู้ให้บริการสำหรับการแก้ไข การเปิดใช้งานอีกครั้ง หรือการส่งซ้ำ

ควรใช้การโพลหรือเว็บฮุก

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

สามารถใช้หมายเลขติดตามเป็นตัวระบุการจัดส่งเพียงรายการเดียวในฐานข้อมูลได้หรือไม่

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

แหล่งข้อมูล

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