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

คู่มือนี้จัดทำขึ้นสำหรับนักพัฒนาและทีมปฏิบัติการที่ผสานการติดตามการจัดส่งเข้ากับระบบจัดการคำสั่งซื้อ เวิร์กโฟลว์คลังสินค้า พอร์ทัลลูกค้า หรือแอปพลิเคชันอีคอมเมิร์ซ เป้าหมายไม่ใช่การพิสูจน์ว่าพัสดุมีอยู่จริงก่อนส่งคำขอ การตรวจสอบทางไวยากรณ์และการตรวจสอบสถานะการจัดส่งเป็นขั้นตอนที่แยกจากกัน
สิ่งที่การตรวจสอบยืนยันได้และยืนยันไม่ได้
ตัวตรวจสอบก่อนส่งคำขอสามารถระบุปัญหาอินพุตทั่วไป เช่น ค่าว่าง ช่องว่างที่เกิดขึ้นโดยไม่ตั้งใจ อักขระที่ไม่รองรับ ความยาวมากเกินไป หรือการใส่หมายเลขติดตามไว้ในฟิลด์ที่ไม่ถูกต้อง นอกจากนี้ยังอาจระบุผู้ให้บริการที่น่าจะเป็นไปได้เมื่อทราบผู้ให้บริการและมีการบันทึกรูปแบบไว้
โดยปกติแล้วไม่สามารถยืนยันได้ว่าหมายเลขนั้นเป็นของการจัดส่งจริง พัสดุได้รับการรับโดยผู้ให้บริการแล้ว หรือหมายเลขนั้นสามารถติดตามได้ในขณะนี้ คำถามเหล่านี้ต้องใช้การค้นหาจากผู้ให้บริการหรือแพลตฟอร์มติดตาม หมายเลขอาจผ่านการตรวจสอบรูปแบบแต่ยังไม่ได้ใช้งาน พิมพ์ผิดเล็กน้อย หมดอายุ หรือเชื่อมโยงกับบริการอื่น
กฎ 7 ข้อ
1. ปรับค่าให้เป็นมาตรฐานโดยไม่เปลี่ยนความหมาย
ผู้ใช้และระบบต้นทางมักเพิ่มช่องว่างด้านหน้าและด้านท้าย การขึ้นบรรทัดใหม่ ช่องว่างแบบไม่ตัดบรรทัด หรืออักขระจัดรูปแบบ ควรปรับค่าเหล่านี้อย่างปลอดภัยก่อนตรวจสอบ ขั้นตอนแรกที่ใช้กันทั่วไปคือการตัดช่องว่างรอบข้างและแปลงช่องว่างที่ไม่แสดงผลให้เป็นช่องว่างปกติ หากรูปแบบที่ผู้ให้บริการระบุอนุญาตให้มีช่องว่างหรือยัติภังค์ภายใน ให้ตัดสินใจว่าจะลบออกสำหรับคำขอ API หรือเก็บค่าดั้งเดิมไว้เพื่อแสดงผลและตรวจสอบย้อนหลัง
เมื่อทำได้จริง ควรเก็บค่าไว้สองแบบ ได้แก่ อินพุตดั้งเดิมและค่ามาตรฐาน อินพุตดั้งเดิมช่วยให้ทีมสนับสนุนตรวจสอบปัญหาคุณภาพข้อมูล ส่วนค่ามาตรฐานใช้สำหรับการตรวจสอบและการส่งคำขอ หลีกเลี่ยงการแปลงที่อาจเปลี่ยนตัวระบุ อย่าแปลงตัวอักษรเป็นตัวเลขแทนโดยอัตโนมัติ แทนที่อักขระที่คลุมเครือ หรือลบเครื่องหมายวรรคตอนทั้งหมด เว้นแต่เอกสารของผู้ให้บริการหรือ API ที่เกี่ยวข้องจะรองรับอย่างชัดเจน
ควรให้ความสำคัญกับการจัดการ Unicode อักขระจากตัวอักษรคนละชุดที่ดูคล้ายกันอาจไม่ได้รับการยอมรับจาก API แม้จะดูเหมือนตัวอักษรหรือตัวเลข ASCII การจำกัดค่ามาตรฐานให้ใช้เฉพาะชุดอักขระที่การผสานระบบที่เลือกอนุญาต จะช่วยป้องกันข้อผิดพลาดที่สับสนในขั้นตอนถัดไป
2. ปฏิเสธค่าที่ไม่ผ่านการตรวจสอบโครงสร้างพื้นฐาน
ก่อนใช้ตรรกะเฉพาะผู้ให้บริการ ให้ตรวจสอบว่าค่านั้นมีอยู่และดูสมเหตุสมผลหรือไม่ การตรวจสอบที่มีประโยชน์ได้แก่ ความยาวขั้นต่ำและสูงสุด คลาสอักขระที่อนุญาต และการตรวจว่าค่านั้นมีแต่ช่องว่าง หรือเป็นตัวยึดตำแหน่ง เช่น “N/A”, “TBD” หรือ “test” ขีดจำกัดที่แน่นอนควรมาจากสัญญา API หรือเอกสารของผู้ให้บริการ หลีกเลี่ยงการคิดค่าความยาวสูงสุดแบบสากลขึ้นเองเพียงเพราะตัวอย่างส่วนใหญ่มีความยาวสั้น
การตรวจสอบโครงสร้างควรมีความระมัดระวังอย่างจงใจ ตัวอย่างเช่น กฎที่อนุญาตเฉพาะตัวเลขจะปฏิเสธตัวระบุแบบตัวอักษรผสมตัวเลขที่ถูกต้อง กฎที่กำหนดความยาวตายตัวอาจปฏิเสธรูปแบบของบริการหรือรูปแบบระหว่างประเทศ ใช้การตรวจสอบทั่วไปเพื่อจับข้อผิดพลาดที่เห็นได้ชัด จากนั้นจึงใช้การตรวจสอบที่เฉพาะเจาะจงมากขึ้นเมื่อทราบผู้ให้บริการและบริการ
ควรตรวจสอบชนิดข้อมูลที่ขอบเขตของแอปพลิเคชันด้วย โดยทั่วไปควรถือว่าหมายเลขติดตามเป็นสตริง ไม่ใช่จำนวนเต็ม การแปลงเป็นตัวเลขอาจลบเลขศูนย์นำหน้าและทำให้เกิดปัญหาความแม่นยำในระบบที่ใช้ชนิดตัวเลขความกว้างคงที่ ให้เก็บค่าเป็นสตริงตามเดิมหลังการปรับมาตรฐานที่ได้รับอนุมัติ
3. ใช้บริบทของผู้ให้บริการแทนการคาดเดาจากหมายเลขเพียงอย่างเดียว
หมายเลขติดตามที่ไม่มีข้อมูลผู้ให้บริการเป็นอินพุตที่คลุมเครือ ผู้ให้บริการต่างรายอาจใช้ความยาว คำนำหน้า หรือชุดอักขระที่ทับซ้อนกันได้ และรูปแบบที่ดูสมเหตุสมผลสำหรับผู้ให้บริการรายหนึ่งอาจไม่ถูกต้องสำหรับอีกราย หากคำสั่งซื้อ ฉลาก ระบบคลังสินค้า หรือบัญชีผู้ค้าระบุผู้ให้บริการไว้แล้ว ให้ส่งบริบทนั้นไปพร้อมกับหมายเลขติดตามเมื่อ API รองรับ
บริบทของผู้ให้บริการช่วยปรับปรุงทั้งการตรวจสอบและการกำหนดเส้นทาง ทำให้แอปพลิเคชันเลือกกฎรูปแบบที่เกี่ยวข้องได้ ลดการจับคู่ผิด และทำให้ข้อความแสดงข้อผิดพลาดมีประโยชน์มากขึ้น นอกจากนี้ยังป้องกันไม่ให้ผลการตรวจหาอัตโนมัติถูกถือเป็นข้อเท็จจริงเมื่อมีผู้ให้บริการหลายรายที่อาจยอมรับค่าซึ่งมีลักษณะคล้ายกัน
หากไม่ทราบผู้ให้บริการ ให้ใช้แนวทางสองขั้นตอน ขั้นแรกใช้การตรวจสอบความปลอดภัยทั่วไป จากนั้นส่งค่าเฉพาะผ่านเวิร์กโฟลว์ API ที่รองรับการตรวจหาผู้ให้บริการอย่างชัดเจน หรือส่งเข้าคิวตรวจสอบเมื่อกระบวนการทางธุรกิจกำหนดให้ต้องยืนยันผู้ให้บริการ อย่ากำหนดผู้ให้บริการโดยอาศัยคำนำหน้าเพียงอย่างเดียวโดยไม่แจ้งให้ทราบ เว้นแต่การจับคู่นั้นได้รับการดูแลและจัดทำเอกสารไว้
4. ใช้ checksum เฉพาะเมื่อมีกฎระบุไว้ในเอกสาร
ระบบตัวระบุบางประเภทใช้หลักตรวจสอบ แต่หมายเลขติดตามไม่ได้อยู่ภายใต้มาตรฐาน checksum สากลแบบเดียว checksum สามารถตรวจพบข้อผิดพลาดในการถอดข้อมูลบางประเภทได้ แต่ไม่สามารถพิสูจน์ว่ามีการจัดส่งอยู่จริง ที่สำคัญกว่านั้น การใช้อัลกอริทึม checksum ที่ไม่ถูกต้องอาจทำให้หมายเลขที่ถูกต้องถูกปฏิเสธ
ให้ใช้งาน checksum เฉพาะเมื่อผู้ให้บริการ บริการ ข้อกำหนดของฉลาก หรือเอกสาร API ที่เกี่ยวข้องระบุอัลกอริทึมและส่วนของอินพุตที่อยู่ภายใต้การตรวจสอบไว้อย่างชัดเจน บันทึกเวอร์ชันของกฎและทดสอบกับตัวอย่างอย่างเป็นทางการ หากไม่มีกฎที่เชื่อถือได้ ให้ข้าม checksum แทนการคาดเดาจากรูปแบบที่พบในตัวอย่างจำนวนน้อย
ให้ถือว่าผล checksum เป็นสัญญาณหนึ่ง ไม่ใช่การตัดสินใจตรวจสอบที่สมบูรณ์ การตรวจสอบไม่ผ่านอาจเป็นเหตุผลให้บล็อกการส่งคำขอเมื่อกฎนั้นเป็นข้อกำหนดที่เชื่อถือได้ ส่วนการตรวจสอบผ่านควรเลื่อนค่าไปยังขั้นตอนถัดไป ไม่ใช่ทำเครื่องหมายว่าเป็นการจัดส่งที่กำลังใช้งาน
5. แยกการตรวจสอบรูปแบบออกจากสิทธิ์ในการใช้ API
ค่าอาจมีรูปแบบถูกต้องแต่ยังไม่เหมาะสมกับ endpoint ที่กำลังเรียกใช้ ก่อนส่งคำขอ ให้ตรวจสอบเอกสาร API เกี่ยวกับฟิลด์ที่จำเป็น ตัวระบุผู้ให้บริการที่ยอมรับ ข้อกำหนดการยืนยันตัวตน ขีดจำกัดคำขอ พฤติกรรมเมื่อพบรายการซ้ำ และข้อจำกัดเกี่ยวกับประเภทบริการหรือปลายทาง สิ่งเหล่านี้เป็นกฎการผสานระบบ ไม่ใช่กฎของหมายเลขติดตาม แต่เป็นตัวกำหนดว่าตัวระบุที่ถูกต้องจะประมวลผลสำเร็จหรือไม่
เอกสาร 17TRACK Tracking API แสดงให้เห็นว่าเหตุใดความแตกต่างนี้จึงสำคัญ นักพัฒนาต้องปฏิบัติตามรูปแบบคำขอของแพลตฟอร์มและพฤติกรรมการผสานระบบที่รองรับ แทนการสร้างคำขอจากลักษณะของหมายเลขติดตามเอง ดูเอกสารปัจจุบันเกี่ยวกับข้อกำหนดของ endpoint และการจัดการผลลัพธ์ได้ที่ เอกสาร 17TRACK API
แยกข้อผิดพลาดจากการตรวจสอบออกจากข้อผิดพลาดด้านการส่งข้อมูลและการยืนยันตัวตน “รูปแบบหมายเลขติดตามไม่ถูกต้อง” “ไม่ทราบผู้ให้บริการ” “ถึงขีดจำกัดอัตราคำขอ” และ “การอนุญาตล้มเหลว” ต้องใช้การดำเนินการที่แตกต่างกัน ข้อความทั่วไปเพียงข้อความเดียวว่า “ส่งคำขอล้มเหลว” ทำให้การลองใหม่และการรายงานเชิงปฏิบัติการไม่น่าเชื่อถือ
6. ปกป้อง API ด้วยอินพุตที่มีขอบเขต การกำจัดรายการซ้ำ และการลองใหม่อย่างปลอดภัย
การตรวจสอบยังเป็นมาตรการป้องกันด้านการปฏิบัติงานด้วย กำหนดความยาวอินพุตสูงสุดก่อนแยกวิเคราะห์หรือบันทึก ปฏิเสธอักขระควบคุมและโครงสร้างข้อมูลที่ไม่คาดคิด ใช้การจำกัดอัตราคำขอที่ขอบเขตแอปพลิเคชันของคุณเอง เพื่อไม่ให้การนำเข้าที่ผิดพลาดสร้างคำขอจำนวนมากอย่างควบคุมไม่ได้
กำจัดรายการซ้ำก่อนส่งเมื่อกระบวนการทางธุรกิจไม่จำเป็นต้องลงทะเบียนซ้ำ คีย์สำหรับกำจัดรายการซ้ำที่มีประโยชน์อาจประกอบด้วยหมายเลขติดตามมาตรฐาน ผู้ให้บริการ บัญชี และบริบทการจัดส่ง คีย์ที่ถูกต้องขึ้นอยู่กับเวิร์กโฟลว์ของคุณ ตัวระบุเดียวกันอาจถูกนำกลับมาใช้กับบริการหรือระเบียนธุรกิจต่างกันได้ ดังนั้นอย่าคิดว่าหมายเลขเพียงอย่างเดียวจะไม่ซ้ำกันทั่วโลกเสมอ
ใช้การลองใหม่ที่มีขอบเขตพร้อม backoff สำหรับความล้มเหลวชั่วคราว และหลีกเลี่ยงการลองใหม่สำหรับข้อผิดพลาดการตรวจสอบถาวร บันทึก idempotency หรือระเบียนการส่งคำขอเมื่อ API และสถาปัตยกรรมของคุณรองรับ บันทึกข้อมูลให้เพียงพอสำหรับแก้ไขปัญหา แต่ปกป้องข้อมูลรับรอง ข้อมูลลูกค้า และรายละเอียดการจัดส่งที่ละเอียดอ่อน ตัวตรวจสอบควรลดความล้มเหลวซ้ำ ไม่ใช่สร้างปัญหาด้านความปลอดภัยครั้งที่สองจากการบันทึกข้อมูลมากเกินไป
7. ยืนยันผลหลังส่งคำขอและติดตาม false positives
กฎสุดท้ายคือให้ถือว่าการตรวจสอบก่อนส่งเป็นประตู ไม่ใช่คำตัดสิน หลังจากรับคำขอแล้ว ให้ตรวจสอบผลตอบกลับ API และบันทึกสถานะ ตัวระบุคำขอ ความเชื่อมโยงกับผู้ให้บริการ และรหัสข้อผิดพลาดที่มีการจัดทำเอกสารไว้ หากแพลตฟอร์มรับคำขอแต่ยังไม่สามารถส่งคืนเหตุการณ์การเคลื่อนไหวได้ อาจหมายถึงการประมวลผลล่าช้า ไม่ใช่หมายเลขไม่ถูกต้อง
กำหนดนโยบายติดตามผลสำหรับหมายเลขที่ยังไม่สามารถระบุผลได้ ช่วงเวลาควรสอดคล้องกับผู้ให้บริการ บริการ ต้นทางการจัดส่ง และนโยบายบริการลูกค้าของคุณ ไม่มีช่วงเวลาแบบสากลที่พิสูจน์ว่าหมายเลขไม่ถูกต้องได้ ส่งต่อระเบียนที่ไม่มีผู้ให้บริการ มีข้อผิดพลาดจากผู้ให้บริการซ้ำ ๆ ได้ผลผู้ให้บริการขัดแย้งกัน หรือมีสถานะไม่ตรงกับระเบียนคำสั่งซื้อ
วัดการปฏิเสธที่ผิดพลาดและการยอมรับที่ผิดพลาด นิพจน์ทั่วไปที่เข้มงวดอาจลดคำขอที่มีรูปแบบผิด แต่บล็อกการจัดส่งที่ถูกต้อง นิพจน์ที่ผ่อนปรนอาจเพิ่มคำขอที่ยอมรับได้ แต่สร้างข้อมูลรบกวนในขั้นตอนถัดไป ตรวจสอบตัวอย่างที่ล้มเหลวแยกตามผู้ให้บริการและบริการ อัปเดตกฎที่จัดทำเอกสารผ่านการควบคุมเวอร์ชัน และทดสอบการเปลี่ยนแปลงกับชุดข้อมูลทดสอบที่เป็นตัวแทนและปกป้องความเป็นส่วนตัว
ลำดับการตรวจสอบที่ใช้งานได้จริง
การใช้งานที่ดูแลรักษาได้สามารถใช้ลำดับต่อไปนี้:
- ตรวจสอบว่าคำขอมีค่าแบบสตริงและระเบียนธุรกิจที่ถูกต้อง
- บันทึกอินพุตดั้งเดิม จากนั้นสร้างรูปแบบมาตรฐานที่มีเอกสารกำกับ
- ปฏิเสธค่าว่าง ตัวยึดตำแหน่ง อักขระที่ไม่ปลอดภัย และค่าที่อยู่นอกช่วงความยาวที่ระบุไว้ในเอกสาร
- ระบุผู้ให้บริการจากข้อมูลคำสั่งซื้อที่เชื่อถือได้ หรือใช้ขั้นตอนการตรวจหาที่รองรับอย่างชัดเจน
- ใช้กฎไวยากรณ์และ checksum เฉพาะผู้ให้บริการเมื่อมีเอกสารที่เชื่อถือได้รองรับเท่านั้น
- ตรวจสอบข้อกำหนดของ endpoint สถานะรายการซ้ำ และสิทธิ์ในการลองใหม่
- ส่งคำขอ จัดประเภทผลตอบกลับ บันทึกผล และกำหนดการติดตามผลสำหรับระเบียนที่ยังไม่สามารถระบุผลได้
ลำดับนี้ทำให้ตัวตรวจสอบทดสอบได้ง่ายขึ้น เพราะแต่ละการตัดสินใจมีเหตุผลแตกต่างกัน นอกจากนี้ยังช่วยให้ทีมปฏิบัติการเห็นหมวดหมู่ความล้มเหลวที่นำไปดำเนินการได้ แทนที่จะได้รับข้อผิดพลาดทึบแสงเพียงรายการเดียว
รายการตรวจสอบการใช้งาน
- จัดเก็บหมายเลขติดตามเป็นสตริงเพื่อรักษาเลขศูนย์นำหน้า
- เก็บค่าดั้งเดิมและค่ามาตรฐานแยกกันเมื่อจำเป็นต้องตรวจสอบย้อนหลัง
- ดูแลกฎของผู้ให้บริการเป็นการกำหนดค่าที่มีเวอร์ชัน ไม่ใช่เงื่อนไขที่เขียนตายตัวกระจัดกระจาย
- ทดสอบตัวอักษร ตัวเลข ยัติภังค์ ช่องว่าง อักขระ Unicode ที่ดูคล้ายกัน ตัวยึดตำแหน่ง และความยาวที่ขอบเขต
- ใช้บริบทผู้ให้บริการที่เชื่อถือได้เมื่อมีข้อมูล
- อย่าสรุปว่ามีการจัดส่งอยู่จริงจากการจับคู่ regular expression ที่สำเร็จ
- จัดประเภทข้อผิดพลาดการตรวจสอบถาวรแยกจากข้อผิดพลาด API หรือเครือข่ายชั่วคราว
- ตรวจสอบเอกสารของผู้ให้บริการก่อนเปลี่ยนกฎรูปแบบหรือตรรกะคำขอ
คำถามที่พบบ่อย
Regular expression สามารถตรวจสอบหมายเลขติดตามได้หรือไม่?
สามารถตรวจสอบรูปแบบที่จำกัดได้เมื่อทราบรูปแบบของผู้ให้บริการและบริการ แต่ไม่สามารถพิสูจน์ว่าหมายเลขนั้นมีอยู่ เป็นของการจัดส่งใด หรือยังใช้งานอยู่ นิพจน์แบบสากลมีแนวโน้มทำให้เกิดการปฏิเสธที่ผิดพลาดหรือการจับคู่ที่ผิดพลาด
ควรส่งหมายเลขที่ดูไม่ถูกต้องไปยัง API หรือไม่?
โดยปกติควรหยุดค่าที่ว่าง ไม่ปลอดภัย หรือเป็นไปไม่ได้ทางโครงสร้างอย่างชัดเจนก่อนส่งคำขอ รูปแบบที่ไม่คุ้นเคยแต่ปลอดภัยในด้านอื่นไม่ควรถูกปฏิเสธเพียงเพราะไม่ตรงกับการคาดเดาภายใน ตรวจสอบเอกสารของผู้ให้บริการหรือใช้กระบวนการตรวจหาที่รองรับก่อน
checksum เพียงพอสำหรับยืนยันการจัดส่งหรือไม่?
ไม่เพียงพอ checksum เมื่อใช้ได้ จะทดสอบเพียงว่าค่านั้นเป็นไปตามกฎทางคณิตศาสตร์หรือไม่ ไม่ได้ยืนยันว่าผู้ให้บริการออกหมายเลขดังกล่าวหรือพัสดุเข้าสู่เครือข่ายแล้ว
ควรทำอย่างไรเมื่อไม่ทราบผู้ให้บริการ?
ใช้การตรวจสอบความปลอดภัยทั่วไปและเวิร์กโฟลว์ API ที่รองรับการตรวจหาผู้ให้บริการอย่างชัดเจน หากมี มิฉะนั้นให้เก็บระเบียนไว้เพื่อเพิ่มข้อมูลหรือตรวจสอบด้วยตนเอง แทนการคาดเดาผู้ให้บริการโดยไม่แจ้งให้ทราบ
ควรจัดการข้อผิดพลาดของ API อย่างไร?
จัดประเภทตามสาเหตุ แก้ไขอินพุตที่มีรูปแบบผิดและค่าผู้ให้บริการที่ไม่รองรับ ลองใหม่สำหรับความล้มเหลวชั่วคราวของเครือข่ายหรือผู้ให้บริการโดยมีขีดจำกัดและ backoff และส่งข้อผิดพลาดด้านการยืนยันตัวตนหรือโควตาให้เจ้าของการผสานระบบ จัดเก็บรายละเอียดผลตอบกลับที่จำเป็นต่อการวินิจฉัยโดยไม่เปิดเผยข้อมูลลับ
แหล่งข้อมูล
- 17TRACK API Documentation — คำแนะนำด้านคำขอและการผสานระบบสำหรับนักพัฒนา tracking API
- 17TRACK Tracking API — ข้อมูลผลิตภัณฑ์อย่างเป็นทางการและกรณีการใช้งาน API
- USPS Tracking — จุดเริ่มต้นการติดตามอย่างเป็นทางการของผู้ให้บริการและคำแนะนำสำหรับลูกค้า
- UPS Tracking — จุดเริ่มต้นการติดตามอย่างเป็นทางการของผู้ให้บริการ


