Skip to main content
หน้าหลักบล็อกคู่มือวิธีรับสถานะการจัดส่งล่าสุดผ่าน API โดยไม่ต้องรอ Webhook

วิธีรับสถานะการจัดส่งล่าสุดผ่าน API โดยไม่ต้องรอ Webhook

17TRACK

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

วิธีรับสถานะการจัดส่งล่าสุดผ่าน API โดยไม่ต้องรอ

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

ตัดสินใจว่า “สถานะการจัดส่งล่าสุด” หมายถึงอะไร

ก่อนเลือก endpoint ให้แยกความแตกต่างระหว่างการดำเนินการสามแบบที่อาจฟังดูคล้ายกัน แต่ให้ผลลัพธ์ต่างกัน

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

ใช้ query เมื่อคุณต้องการคำตอบทันที ตรวจสอบการดำเนินการรีเฟรชเฉพาะเมื่อคุณต้องการให้ผู้ให้บริการพยายามตรวจสอบข้อมูลจากต้นทางอีกครั้ง อย่าสันนิษฐานว่าการเพิ่มพารามิเตอร์ป้องกันแคช การส่งคำขอซ้ำ หรือการส่ง HTTP cache-control header จะบังคับให้ผู้ให้บริการขนส่งส่งข้อมูลใหม่

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

17TRACK API Global Shipment Tracking Solutionเชื่อมต่อกับผู้ให้บริการขนส่งกว่า 3,500 รายทั่วโลกผ่าน API เดียว เพื่อการติดตามพัสดุที่ง่าย แม่นยำ และเชื่อถือได้ทดลองใช้ฟรี →

ตรวจสอบสัญญาการ query ก่อนเขียนโค้ด

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

  • ตัวตนของพัสดุ: query รองรับหมายเลขติดตาม รหัสพัสดุภายใน หรือหมายเลขติดตามที่ใช้ร่วมกับตัวระบุผู้ให้บริการขนส่งหรือไม่
  • ข้อกำหนดการลงทะเบียน: ต้องลงทะเบียนพัสดุก่อนจึงจะ query ได้หรือไม่
  • การยืนยันตัวตน: ต้องใช้ header หรือกลไกการยืนยันตัวตนใด
  • ความหมายของการตอบกลับ: การดำเนินการนี้ส่งคืนข้อมูลที่จัดเก็บไว้ เริ่มการรวบรวมข้อมูล หรือส่งคืน job ให้ตรวจสอบภายหลัง
  • การจัดการผลลัพธ์: HTTP response ที่สำเร็จอาจมีความล้มเหลวระดับพัสดุหรือผลลัพธ์ที่ยังรอดำเนินการได้หรือไม่
  • ข้อจำกัดการใช้งาน: มี rate limit, batch limit และข้อจำกัดเฉพาะบัญชีใดบ้าง
  • ฟิลด์ความใหม่ของข้อมูล: timestamp ใดแสดงเหตุการณ์ของผู้ให้บริการขนส่ง การอัปเดตของผู้ให้บริการ และการสร้าง response

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

หลีกเลี่ยงการ hard-code สมมติฐานเกี่ยวกับพฤติกรรมการรีเฟรชหรือความถี่ในการ query รายละเอียดเหล่านี้ต้องสอดคล้องกับการดำเนินการและข้อกำหนดการให้บริการที่คุณใช้งานจริง

สร้างการค้นหาตามต้องการผ่าน backend ของคุณ

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

17RETURNS Returns & Exchanges Solutionลดต้นทุนการสนับสนุนและรักษารายได้ให้มากขึ้นด้วยการคืนสินค้าและเปลี่ยนสินค้าอัตโนมัติ พร้อมเครื่องมือรักษาลูกค้าอัจฉริยะทดลองใช้ฟรี →

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

GET /api/orders/{order_id}/shipment-status

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

ขั้นตอนคำขอที่คุณสามารถนำไปใช้ได้

  1. อนุญาตการเข้าถึง ยืนยันว่าลูกค้าหรือเจ้าหน้าที่มีสิทธิ์ดูคำสั่งซื้อ
  2. ระบุพัสดุ อ่านตัวระบุการติดตามและข้อมูลผู้ให้บริการขนส่งที่จัดเก็บไว้ หากมี
  3. ตรวจสอบความใหม่ในระบบภายใน หากมี query ที่สำเร็จล่าสุดอยู่แล้ว ให้ใช้ซ้ำตามนโยบายความใหม่ของแอปพลิเคชัน
  4. Query ผู้ให้บริการเมื่อจำเป็น ใช้การดำเนินการตามเอกสารและกำหนด request timeout ที่มีขอบเขต
  5. ตรวจสอบผลลัพธ์ ตรวจสอบทั้งผลลัพธ์ HTTP และผลลัพธ์ระดับพัสดุ
  6. รวมข้อมูล ใช้กฎการทำให้เป็นมาตรฐานและการกระทบยอดเดียวกับที่ใช้กับเหตุการณ์จาก webhook
  7. ส่งคืนสถานะและความใหม่ รวมเวลาของเหตุการณ์ล่าสุดและเวลาที่ตรวจสอบกับผู้ให้บริการสำเร็จล่าสุดเมื่อมีข้อมูล

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

ทำ response ให้เป็นมาตรฐานโดยไม่สร้างข้อมูลความใหม่ขึ้นเอง

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

{
  "shipment_id": "internal-shipment-id",
  "status": "in_transit",
  "latest_event_at": null,
  "provider_updated_at": null,
  "last_successful_query_at": null,
  "retrieval_state": "success",
  "source": "provider_query"
}

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

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

ป้องกันไม่ให้ API query และ webhook เขียนทับข้อมูลกัน

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

อย่าใช้ตรรกะให้ response ล่าสุดเป็นผู้ชนะ payload ที่ได้รับล่าสุดไม่จำเป็นต้องเป็นสถานะพัสดุล่าสุด

  • ใช้ pipeline การอัปเดตร่วมกัน ส่งผลลัพธ์จาก query และ payload จาก webhook ผ่านฟังก์ชันตรวจสอบ ทำให้เป็นมาตรฐาน และบันทึกข้อมูลชุดเดียวกัน
  • กำจัดเหตุการณ์ซ้ำ ให้เลือกใช้ตัวระบุเหตุการณ์ตามเอกสาร หากไม่มี ให้สร้าง fingerprint ที่กำหนดไว้อย่างรอบคอบจากฟิลด์ที่มี เช่น เวลาเหตุการณ์ สถานะ ตำแหน่ง และคำอธิบาย
  • ใช้ฟิลด์ลำดับที่มีความหมายชัดเจน revision หรือ sequence ตามเอกสารมีประโยชน์มากกว่าการสันนิษฐานว่าเวลาที่ได้รับคือเวลาของลำดับเหตุการณ์
  • เก็บประวัติไว้ เหตุการณ์ใหม่ที่ได้รับอาจเติมช่องว่างในประวัติโดยไม่เปลี่ยนสรุปสถานะปัจจุบันของพัสดุ
  • อนุญาตการแก้ไข สถานะไม่ได้เป็นลำดับเชิงเส้นสากล ให้ปฏิบัติตามพฤติกรรมการแก้ไขที่ระบุไว้ แทนการปฏิเสธการเปลี่ยนย้อนกลับที่ดูเหมือนผิดทุกกรณี

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

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

ผลลัพธ์ว่าง ผลลัพธ์ที่ไม่เปลี่ยนแปลง และคำขอที่ล้มเหลวไม่ควรสร้างข้อความเดียวกันสำหรับลูกค้า

Query สำเร็จแต่สถานะยังไม่เปลี่ยน

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

พัสดุยังไม่มีข้อมูลการติดตาม

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

คำขอไปยังผู้ให้บริการหมดเวลาหรือล้มเหลว

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

ใช้การ retry ที่มีขอบเขตพร้อม backoff และ jitter สำหรับความล้มเหลวชั่วคราวที่เหมาะสม อย่า retry ข้อมูลรับรองที่ไม่ถูกต้องหรือคำขอที่มีรูปแบบผิดซ้ำ ๆ หาก response มี Retry-After ให้ตีความตามสัญญาของผู้ให้บริการและ semantics ของ HTTP ข้อกำหนด HTTP อนุญาตให้ค่านี้อยู่ในรูปจำนวนวินาทีที่ต้องรอหรือวันที่แบบ HTTP

มีคำขอหลายรายการเข้ามาสำหรับพัสดุเดียวกัน

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

ใช้ polling เป็นทางเลือกสำรองที่ควบคุมได้

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

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

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

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

ทดสอบขั้นตอนการทำงานก่อนเปิดตัว

คำขอที่สำเร็จเป็นเพียงการทดสอบแรก ตรวจสอบสถานการณ์ที่อาจทำให้เกิดการอัปเดตสถานะที่ทำให้เข้าใจผิด:

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

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

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

การ query API บังคับให้ผู้ให้บริการขนส่งสแกนหรืออัปเดตพัสดุหรือไม่

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

ฉันสามารถใช้ API query โดยไม่กำหนดค่า webhook ได้หรือไม่

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

ควรทำ polling สถานะการจัดส่งบ่อยเพียงใด

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

เหตุใด API จึงส่งคืนข้อมูลที่ฉันได้รับผ่าน webhook แล้ว

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

ปุ่มอัปเดตควรเขียนว่า “รีเฟรชการติดตาม” หรือไม่

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

แหล่งข้อมูล

  • 17TRACK Tracking API — ข้อมูลอ้างอิงผลิตภัณฑ์อย่างเป็นทางการสำหรับการผสานรวม tracking API ที่กล่าวถึงในคู่มือนี้
  • เอกสาร 17TRACK API — ข้อมูลอ้างอิงสำหรับการดำเนินการเฉพาะของผู้ให้บริการ การยืนยันตัวตน ฟิลด์คำขอ และการจัดการ response
  • RFC 9110, Section 10.2.3: Retry-After — กำหนดรูปแบบ delay-seconds และ HTTP-date ของ HTTP header