บทนำ
การสมัครรับข้อมูลหมายเลขการติดตามสถานะแบบรวมระบบขั้นสูงได้รับการออกแบบสำหรับผู้สมัครรับข้อมูลการติดตามสถานะแบบรวมระบบขั้นสูงเพื่อจัดการ โครงการเว็บฮุคที่อิงตามหมายเลขการติดตาม และดำเนินการการปฏิบัติงานที่เกี่ยวข้องกับโครงการ เช่น เพิ่มหมายเลขการติดตามใหม่ แก้ไข หรือดูรายละเอียดงานโดยใช้ปลายทาง API
หมายเหตุ:
- คุณต้องมีสิทธิ์การเข้าถึงระดับผู้ดูแลระบบหรือผู้มีส่วนร่วมสำหรับโครงการการติดตามสถานะแบบรวมระบบขั้นสูงของคุณ
- สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการติดตามสถานะแบบรวมระบบขั้นสูงและคุณสมบัติต่างๆ โปรดไปที่หน้าเอกสารประกอบการติดตามสถานะแบบรวมระบบขั้นสูง
ประโยชน์ของการสมัครรับข้อมูลหมายเลขการติดตามสถานะแบบรวมระบบขั้นสูง
ประโยชน์ของการสมัครรับข้อมูลหมายเลขการติดตามสถานะแบบรวมระบบขั้นสูง ได้แก่:
- คุณสามารถอัปเดตและจัดการหมายเลขการติดตามของโครงการการติดตามสถานะแบบรวมระบบขั้นสูงของคุณได้อย่างง่ายดายโดยใช้ปลายทาง API
- API นี้ช่วยให้คุณสามารถเชื่อมโยงหมายเลขการติดตามหลายหมายเลขกับโครงการของคุณในการทำรายการ API เดียว แทนที่จะเชื่อมโยงหมายเลขการติดตามแต่ละหมายเลขทีละหมายเลข
- คุณสามารถส่งคำขอ API ได้อย่างต่อเนื่องและดูรายละเอียดบันทึกความสำเร็จ/ความล้มเหลวของคำขอเหล่านี้ได้
วิธีการทำงานของการสมัครรับข้อมูลหมายเลขการติดตามสถานะแบบรวมระบบขั้นสูง
ใช้ปลายทางด้านล่างเพื่อจัดการโครงการการติดตามสถานะแบบรวมระบบขั้นสูงของคุณ:
สามารถเข้าถึง API นี้ได้ผ่านภาพรวมโครงการของคุณตามที่แสดงในภาพถ่ายหน้าจอด้านบนเท่านั้น
การเชื่อมโยงหมายเลขการติดตาม
ใช้ปลายทางนี้เพื่อเรียกใช้งานอะซิงโครนัสเพื่อเชื่อมโยงหมายเลขการติดตามหนึ่งหมายเลขหรือหลายหมายเลขกับโครงการการติดตามสถานะแบบรวมระบบขั้นสูงที่เฉพาะเจาะจง
ข้อมูลที่จำเป็นสำหรับคำขอนี้ ได้แก่:
- การดำเนินการ – ระบุการดำเนินการที่จะดำเนินการเมื่อคุณส่งคำขอ ตัวอย่าง: เพิ่ม
- รายละเอียดหมายเลขการติดตาม – ระบุหมายเลขการติดตาม
คุณสามารถเชื่อมโยงหมายเลขการติดตามได้สูงสุด 1,000 หมายเลขในคำขอเดียว การตอบกลับที่เสร็จสมบูรณ์สำหรับคำขอนี้จะคืนค่า jobID สถานะงานปัจจุบัน และประทับเวลาการสร้างงานและการเสร็จสิ้นงาน สามารถใช้ jobId นี้ในภายหลังเพื่อตรวจสอบสถานะของงานอะซิงโครนัสได้
สถานะงานหมายเลขการติดตาม
ใช้ปลายทางนี้เพื่อรับสถานะของงานอะซิงโครนัส (คำขอหนึ่งรายการขึ้นไปที่ต่อเนื่องกันในคิว) หรือสถานะของงานทั้งหมดที่ส่ง
ข้อมูลที่จำเป็นสำหรับคำขอนี้ ได้แก่:
- ID งาน– ระบุ ID งานที่คุณต้องการเรียกดูสถานะ
หมายเหตุ: ID งานเป็นข้อมูลป้อนที่ไม่บังคับสำหรับปลายทางนี้ หากคุณไม่ระบุ ID งาน คุณจะได้รับสถานะของงานที่ส่งทั้งหมด
การตอบกลับที่เสร็จสมบูรณ์สำหรับคำขอนี้จะคืนค่า jobID สถานะงานปัจจุบัน และประทับเวลาการสร้างงานและการเสร็จสิ้นงาน การตอบกลับจะแสดงสถานะปัจจุบันของงาน นอกจากนี้ การตอบกลับยังจะมีข้อความประสบความสำเร็จ ข้อผิดพลาด หรือคำเตือนให้ผู้ใช้ดูและแก้ไขปัญหาตามความเหมาะสมอีกด้วย
- หากสถานะงานแสดงเป็นเสร็จสมบูรณ์ แสดงว่าหมายเลขการติดตามทั้งหมดได้รับการตรวจสอบและดำเนินการเสร็จเรียบร้อยแล้ว
- สถานะเสร็จสมบูรณ์แสดงว่าหมายเลขการติดตามได้รับการตรวจสอบและดำเนินการเสร็จเรียบร้อยแล้ว ไม่ได้หมายความว่าหมายเลขการติดตามทั้งหมดได้ถูกเพิ่มไปยังโครงการการติดตามสถานะแบบรวมระบบขั้นสูงเรียบร้อยแล้ว
- หากคุณพยายามเชื่อมโยงหมายเลขการติดตามหลายหมายเลข แต่มีเพียงหมายเลขบางส่วนเท่านั้นที่เชื่อมโยงได้ และหมายเลขที่เหลือไม่สามารถเชื่อมโยงได้ เช่นนั้นสถานะงานก็ยังจะได้รับการอัปเดตเป็นเสร็จสมบูรณ์แล้ว เพื่อยืนยันสถานะของแต่ละหมายเลขการติดตามในคำขอที่เกี่ยวข้อง จะต้องดาวน์โหลดชุดการรายงาน
- หากสถานะงานแสดงเป็นล้มเหลว แสดงว่าเนื่องจากสาเหตุหลายประการหรือความล้มเหลวร้ายแรง ทำให้ไม่สามารถประมวลผลคำขอได้ และผู้ใช้จะต้องลองอีกครั้ง
หมายเหตุ:
ต่อไปนี้เป็นสถานะและคำอธิบายตามลำดับ:
| สถานะงาน | คำอธิบาย |
|---|---|
ส่งแล้ว |
งานจะถูกส่งไปยังระบบหลังจากทำการตรวจสอบพื้นฐานทั้งหมดแล้ว และจะได้รับการประมวลผลแบบอะซิงโครนัส |
ยอมรับแล้ว |
งานได้รับการยอมรับและจะอยู่ในคิว |
ไม่ยอมรับ |
งานไม่ได้รับการยอมรับเนื่องจากความล้มเหลวภายในหรือระบบไม่พร้อมใช้งาน ผู้ใช้จะต้องลองอีกครั้ง |
อยู่ในคิว |
งานอยู่ในคิวเพื่อรอการประมวลผล และการประมวลผลจะเริ่มต้นเมื่อใดก็ได้ |
กำลังดำเนินการ |
งานได้เริ่มต้นแล้วและอยู่ในสถานะกำลังดำเนินการ |
เสร็จสมบูรณ์ |
งานเสร็จสมบูรณ์แล้ว และรายงานการนำเข้าหรือไฟล์ส่งออกพร้อมให้ผู้ใช้ดาวน์โหลดได้ |
ล้มเหลว |
งานล้มเหลวเนื่องจากสาเหตุหลายประการและผู้ใช้จะต้องลองอีกครั้ง |
รายละเอียดงานหมายเลขการติดตาม
ใช้ปลายทางนี้เพื่อดาวน์โหลดรายงาน JSON สำหรับงานอะซิงโครนัสที่มีสถานะเสร็จสมบูรณ์
ข้อมูลที่เกี่ยวข้องกับคำขอนี้ได้แก่:
- ID งาน– ระบุ ID งานที่คุณต้องการเรียกดูสถานะ
หมายเหตุ:
- ID งานเป็นข้อมูลบังคับสำหรับปลายทางนี้
- คุณสามารถดาวน์โหลดรายงานของงานอะซิงโครนัสได้ครั้งละหนึ่งงานเท่านั้น
- หากงานยังไม่เสร็จสมบูรณ์ และคุณพยายามดาวน์โหลดรายงาน ข้อความแสดงข้อผิดพลาดจะปรากฏขึ้น
การตอบกลับที่เสร็จสมบูรณ์สำหรับคำขอนี้จะมอบรายงานของงานให้คุณในรูปแบบ JSON
กฎการดำเนินธุรกิจ
- สามารถเชื่อมโยงหมายเลขการติดตามการจัดส่งได้สูงสุด 1,000 หมายเลขกับโครงการการติดตามสถานะแบบรวมระบบขั้นสูงในแต่ละคำขอ
- ไม่มีข้อจำกัดเกี่ยวกับหมายเลขการติดตามสูงสุดที่คุณสามารถเชื่อมโยงกับโครงการการติดตามสถานะแบบรวมระบบขั้นสูงที่กำหนดให้
- หมายเลขการติดตามใดๆ ที่เชื่อมโยงจะถูกตัดการเชื่อมโยงกับโครงการการติดตามสถานะแบบรวมระบบขั้นสูงที่กำหนดให้หลังจากผ่านไป 40 วัน
- สถานะและรายละเอียด ID งานใดๆ ที่สร้างขึ้นจะไม่สามารถใช้ได้สำหรับโครงการการติดตามสถานะแบบรวมระบบขั้นสูงที่กำหนดให้หลังจากผ่านไป 90 วัน
- ข้อมูลการติดตามที่มีการป้องกัน เช่น ที่อยู่ผู้รับ ลายเซ็นของผู้รับจะไม่สามารถดูได้ผ่านการสมัครรับข้อมูลหมายเลขการติดตามสถานะแบบรวมระบบขั้นสูง
Response