Skip to main content
หน้าหลักบล็อกคู่มือ6 วิธีตรวจสอบเพื่อยืนยันว่าเหตุการณ์ติดตามล่าสุดของผู้ให้บริการขนส่งซิงค์ผ่าน API ของคุณแล้ว

6 วิธีตรวจสอบเพื่อยืนยันว่าเหตุการณ์ติดตามล่าสุดของผู้ให้บริการขนส่งซิงค์ผ่าน API ของคุณแล้ว

17TRACK

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

การตรวจสอบ 6 ประการเพื่อยืนยันว่าเหตุการณ์ติดตามล่าสุดของผู้ให้บริการขนส่งซิงค์แล้ว

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

ก่อนเริ่มต้น: กำหนดความหมายของ “ล่าสุด”

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

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

1. ยืนยันว่าทั้งสองระบบอ้างถึงการจัดส่งเดียวกัน

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

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

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

2. เปรียบเทียบเวลาเหตุการณ์โดยไม่สูญเสียความหมาย

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

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

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

3. ตรวจสอบข้อมูลเหตุการณ์ ไม่ใช่เพียงสถานะหัวข้อ

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

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

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

4. ติดตามว่าเหตุการณ์มาถึงแอปพลิเคชันของคุณอย่างไร

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

หากคุณเรียก API เป็นระยะ ให้ตรวจสอบคำขอที่เสร็จสมบูรณ์ล่าสุด ตัวระบุการจัดส่งในคำขอนั้น การตอบกลับ และตรรกะการแบ่งหน้าหรือการดึงข้อมูลที่การเชื่อมต่อของคุณใช้ คำขอที่สำเร็จอาจตามมาด้วยการเขียนฐานข้อมูลที่ล้มเหลวหรือการอ่านแคชที่ล้าสมัย ใช้เอกสารที่เกี่ยวข้องของผู้ให้บริการเพื่อตรวจสอบฟิลด์การตอบกลับจริง ข้อกำหนดการยืนยันตัวตน และพฤติกรรมการส่งข้อมูลสำหรับการเชื่อมต่อของคุณ แทนการสมมติว่า tracking API ทุกตัวใช้สัญญาเดียวกัน สำหรับการเชื่อมต่อ 17TRACK จุดเริ่มต้นที่เกี่ยวข้องคือ หน้า Tracking API และ เอกสาร API ให้ยืนยันพฤติกรรมตามเอกสารสำหรับ endpoint และเมธอดที่คุณใช้

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

5. ตรวจสอบกฎการจัดลำดับและการเปลี่ยนสถานะ

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

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

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

6. วัดความใหม่ของข้อมูลและกระทบยอดข้อยกเว้น

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

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

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

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

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

การตอบกลับ webhook ที่สำเร็จหมายความว่าเหตุการณ์ล่าสุดซิงค์แล้วหรือไม่?

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

เหตุใดหน้าของผู้ให้บริการขนส่งจึงแสดงการสแกนใหม่กว่าการตอบกลับ API ของฉัน?

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

ฉันควรใช้การประทับเวลาเหตุการณ์หรือเวลาที่ระบบได้รับข้อมูลเพื่อเลือกสถานะล่าสุด?

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

จะทำอย่างไรหากสถานะ API ไม่เปลี่ยนแปลง แต่รายการเหตุการณ์มีรายการใหม่?

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

แหล่งข้อมูล

  • 17TRACK Tracking API — ข้อมูลอ้างอิงผลิตภัณฑ์สำหรับการเชื่อมต่อ tracking API
  • เอกสาร 17TRACK API — จุดอ้างอิงสำหรับตรวจสอบสัญญาการเชื่อมต่อที่เกี่ยวข้อง
  • RFC 3339: Date and Time on the Internet: Timestamps — ข้อมูลอ้างอิงรูปแบบการประทับเวลาและออฟเซ็ต UTC