เวิร์กโฟลว์ 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. รอให้ข้อมูลการติดตามแรกมาถึง
หลังจากการลงทะเบียนได้รับการยอมรับ รายละเอียดการติดตามอาจยังไม่พร้อมใช้งานทันที ใบจ่าหน้าอาจมีอยู่ก่อนที่ผู้ให้บริการขนส่งจะบันทึกเหตุการณ์การจัดการทางกายภาพ ข้อมูลที่หายไปอาจจำเป็นต้องตรวจสอบหมายเลขติดตาม การเลือกผู้ให้บริการขนส่ง หรือข้อกำหนดการค้นหาเฉพาะการจัดส่ง
แสดงเงื่อนไขนี้อย่างชัดเจน “ลงทะเบียนแล้ว; รอข้อมูลการติดตาม” ถูกต้องกว่า “อยู่ระหว่างการขนส่ง” หรือ “การลงทะเบียนล้มเหลว” อย่าสร้างค่าประมาณการจัดส่งหรือเหตุการณ์การเคลื่อนย้ายขึ้นมาเพื่อเติมหน้าจอที่ว่างเปล่า
เมื่อระเบียนยังว่าง ให้ตรวจสอบตามลำดับที่เหมาะสม:
- ยืนยันว่าการลงทะเบียนรายการนั้นได้รับการยอมรับ
- เปรียบเทียบหมายเลขติดตามที่ส่งกับระเบียนการจัดส่งสินค้า
- ตรวจสอบการแมปผู้ให้บริการขนส่งและข้อกำหนดการค้นหาเพิ่มเติมที่ระบุไว้
- ตรวจสอบหน้าติดตามของผู้ให้บริการขนส่งสำหรับการจัดส่งเดียวกัน
- หากผู้ให้บริการมีเหตุการณ์แต่การเชื่อมต่อของคุณไม่มี ให้ตรวจสอบการตอบกลับจากการดึงข้อมูลและติดต่อผู้ให้บริการ 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 นี้


