Fedex Logo

บทนำ

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

หมายเหตุ:

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

ประโยชน์ของการสมัครรับข้อมูลหมายเลขการติดตามสถานะแบบรวมระบบขั้นสูง

ประโยชน์ของการสมัครรับข้อมูลหมายเลขการติดตามสถานะแบบรวมระบบขั้นสูง ได้แก่:

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

วิธีการทำงานของการสมัครรับข้อมูลหมายเลขการติดตามสถานะแบบรวมระบบขั้นสูง

ใช้ปลายทางด้านล่างเพื่อจัดการโครงการการติดตามสถานะแบบรวมระบบขั้นสูงของคุณ:

ภาพ alt ของเว็บฮุค

สามารถเข้าถึง API นี้ได้ผ่านภาพรวมโครงการของคุณตามที่แสดงในภาพถ่ายหน้าจอด้านบนเท่านั้น

การเชื่อมโยงหมายเลขการติดตาม

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

ข้อมูลที่จำเป็นสำหรับคำขอนี้ ได้แก่:

  • การดำเนินการ – ระบุการดำเนินการที่จะดำเนินการเมื่อคุณส่งคำขอ ตัวอย่าง: เพิ่ม
  • รายละเอียดหมายเลขการติดตาม – ระบุหมายเลขการติดตาม

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

สถานะงานหมายเลขการติดตาม

ใช้ปลายทางนี้เพื่อรับสถานะของงานอะซิงโครนัส (คำขอหนึ่งรายการขึ้นไปที่ต่อเนื่องกันในคิว) หรือสถานะของงานทั้งหมดที่ส่ง

ข้อมูลที่จำเป็นสำหรับคำขอนี้ ได้แก่:

  • ID งาน– ระบุ ID งานที่คุณต้องการเรียกดูสถานะ

หมายเหตุ: ID งานเป็นข้อมูลป้อนที่ไม่บังคับสำหรับปลายทางนี้ หากคุณไม่ระบุ ID งาน คุณจะได้รับสถานะของงานที่ส่งทั้งหมด

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

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

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

ต่อไปนี้เป็นสถานะและคำอธิบายตามลำดับ:

สถานะงาน คำอธิบาย

ส่งแล้ว

    งานจะถูกส่งไปยังระบบหลังจากทำการตรวจสอบพื้นฐานทั้งหมดแล้ว และจะได้รับการประมวลผลแบบอะซิงโครนัส

ยอมรับแล้ว

    งานได้รับการยอมรับและจะอยู่ในคิว

ไม่ยอมรับ

    งานไม่ได้รับการยอมรับเนื่องจากความล้มเหลวภายในหรือระบบไม่พร้อมใช้งาน ผู้ใช้จะต้องลองอีกครั้ง

อยู่ในคิว

    งานอยู่ในคิวเพื่อรอการประมวลผล และการประมวลผลจะเริ่มต้นเมื่อใดก็ได้

กำลังดำเนินการ

    งานได้เริ่มต้นแล้วและอยู่ในสถานะกำลังดำเนินการ

เสร็จสมบูรณ์

    งานเสร็จสมบูรณ์แล้ว และรายงานการนำเข้าหรือไฟล์ส่งออกพร้อมให้ผู้ใช้ดาวน์โหลดได้

ล้มเหลว

    งานล้มเหลวเนื่องจากสาเหตุหลายประการและผู้ใช้จะต้องลองอีกครั้ง

รายละเอียดงานหมายเลขการติดตาม

ใช้ปลายทางนี้เพื่อดาวน์โหลดรายงาน JSON สำหรับงานอะซิงโครนัสที่มีสถานะเสร็จสมบูรณ์

ข้อมูลที่เกี่ยวข้องกับคำขอนี้ได้แก่:

  • ID งาน– ระบุ ID งานที่คุณต้องการเรียกดูสถานะ

หมายเหตุ:

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

 

การตอบกลับที่เสร็จสมบูรณ์สำหรับคำขอนี้จะมอบรายงานของงานให้คุณในรูปแบบ JSON

กฎการดำเนินธุรกิจ

  • สามารถเชื่อมโยงหมายเลขการติดตามการจัดส่งได้สูงสุด 1,000 หมายเลขกับโครงการการติดตามสถานะแบบรวมระบบขั้นสูงในแต่ละคำขอ
  • ไม่มีข้อจำกัดเกี่ยวกับหมายเลขการติดตามสูงสุดที่คุณสามารถเชื่อมโยงกับโครงการการติดตามสถานะแบบรวมระบบขั้นสูงที่กำหนดให้
  • หมายเลขการติดตามใดๆ ที่เชื่อมโยงจะถูกตัดการเชื่อมโยงกับโครงการการติดตามสถานะแบบรวมระบบขั้นสูงที่กำหนดให้หลังจากผ่านไป 40 วัน
  • สถานะและรายละเอียด ID งานใดๆ ที่สร้างขึ้นจะไม่สามารถใช้ได้สำหรับโครงการการติดตามสถานะแบบรวมระบบขั้นสูงที่กำหนดให้หลังจากผ่านไป 90 วัน
  • ข้อมูลการติดตามที่มีการป้องกัน เช่น ที่อยู่ผู้รับ ลายเซ็นของผู้รับจะไม่สามารถดูได้ผ่านการสมัครรับข้อมูลหมายเลขการติดตามสถานะแบบรวมระบบขั้นสูง
CLOSE

Response

Copy