Skip to main content
หน้าหลักบล็อกคู่มือวิธีส่งหมายเลขติดตามหลายรายการในคำขอ API เดียว (ขีดจำกัดแบตช์และความล้มเหลวบางส่วน)

วิธีส่งหมายเลขติดตามหลายรายการในคำขอ API เดียว (ขีดจำกัดแบตช์และความล้มเหลวบางส่วน)

17TRACK

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

วิธีส่งหมายเลขติดตามหลายหมายเลขในคำขอ API เดียว

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

ขั้นแรก ระบุว่าแบตช์เอนด์พอยต์ทำอะไรได้จริง

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

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

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

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

ขีดจำกัดของแบตช์มีมากกว่าจำนวนการจัดส่งสูงสุด

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

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

ตัวอย่างเช่น หากเอนด์พอยต์สมมติอนุญาต 25 ระเบียนต่อคำขอ ระเบียน 63 รายการจะต้องใช้คำขอ 3 ครั้ง โดยมี 25, 25 และ 13 รายการ ตัวเลขเหล่านี้มีไว้เพื่อแสดงแนวคิดการแบ่งชุดเท่านั้น ไม่ใช่ขีดจำกัดที่ระบุโดย 17TRACK

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

เตรียมระเบียนก่อนสร้างคำขอ

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

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

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

โครงสร้างคำขอตัวอย่าง

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

{
  "shipments": [
    {
      "tracking_number": "EXAMPLE000001",
      "carrier_id": "DOCUMENTED_CARRIER_ID"
    },
    {
      "tracking_number": "EXAMPLE000002",
      "carrier_id": "DOCUMENTED_CARRIER_ID"
    }
  ]
}

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

ประมวลผลการตอบกลับในสองระดับ

คำขอแบบแบตช์มีผลลัพธ์ระดับการส่งข้อมูลและผลลัพธ์ระดับแอปพลิเคชัน การเชื่อมต่อของคุณต้องประเมินทั้งสองระดับ

ระดับที่ 1: คำขอได้รับการตอบกลับที่ใช้งานได้หรือไม่

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

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

ระดับที่ 2: เกิดอะไรขึ้นกับการจัดส่งแต่ละรายการ

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

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

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

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

จัดการความล้มเหลวบางส่วนโดยไม่ส่งระเบียนที่สำเร็จซ้ำ

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

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

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

HTTP 429 หมายถึงมีคำขอมากเกินไป และการตอบกลับอาจมีส่วนหัว Retry-After ตามที่อธิบายไว้ใน RFC 6585 อย่าสันนิษฐานว่าส่วนหัวนี้จะมีอยู่เสมอ เมื่อไม่มีการระบุระยะเวลาลองใหม่อย่างชัดเจน ให้ใช้นโยบาย backoff ที่มีขอบเขตและสอดคล้องกับเอกสารของ API

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

เหตุใดการหมดเวลาจึงต้องจัดการเป็นพิเศษ

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

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

เวิร์กโฟลว์การประมวลผลแบตช์ที่ใช้งานได้จริง

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

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

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

    หากผลลัพธ์ไม่แน่นอน:
        ใส่คิวการกระทบยอด
        ดำเนินการต่อ

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

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

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

ตรวจสอบผลลัพธ์การจัดส่ง ไม่ใช่แค่เวลาทำงานของ HTTP

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

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

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

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

ทดสอบกรณีเหล่านี้ก่อนใช้งานจริง

ใช้ sandbox ที่ระบุไว้ในเอกสารหรือสภาพแวดล้อมทดสอบที่ควบคุมได้เมื่อมีให้บริการ อย่าสันนิษฐานว่าหมายเลขติดตามที่สร้างขึ้นเองจะให้การตอบกลับในการใช้งานจริงที่คาดเดาได้

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

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

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

ฉันสามารถส่งหมายเลขติดตามได้กี่หมายเลขในคำขอเดียว

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

หมายเลขติดตามที่ไม่ถูกต้องหนึ่งหมายเลขทำให้แบตช์ทั้งหมดล้มเหลวได้หรือไม่

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

ฉันควรลองส่งแบตช์อีกครั้งเมื่อการตอบกลับ HTTP สำเร็จหรือไม่

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

ฉันสามารถผสมผู้ให้บริการหลายรายในแบตช์เดียวกันได้หรือไม่

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

การรวมแบตช์ทำให้การอัปเดตการติดตามมาถึงเร็วขึ้นหรือไม่

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

แหล่งข้อมูล

  • 17TRACK Tracking API — จุดเริ่มต้นผลิตภัณฑ์อย่างเป็นทางการสำหรับนักพัฒนาที่ประเมินการเชื่อมต่อระบบติดตาม
  • เอกสาร 17TRACK API — ข้อมูลอ้างอิงเกี่ยวกับสัญญาเอนด์พอยต์ ขีดจำกัด การยืนยันตัวตน และการจัดการการตอบกลับเฉพาะของผู้ให้บริการ
  • RFC 9110: HTTP Semantics — ความหมายของสถานะ HTTP, idempotency, การลองใหม่อัตโนมัติ และ Retry-After
  • RFC 6585: Additional HTTP Status Codes — คำจำกัดความของ HTTP 429 Too Many Requests และส่วนหัว Retry-After ที่เป็นตัวเลือก