การติดตามสถานะแบบรวมระบบขั้นสูงทำงานอย่างไร
ภาพรวมเว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูง
เว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูงช่วยให้ FedEx สามารถส่งข้อมูลการติดตามกิจกรรมแบบเกือบเรียลไทม์ไปยัง URL ปลายทางเฉพาะได้อย่างปลอดภัย สำหรับการจัดส่งที่เชื่อมโยงกับหมายเลขบัญชี FedEx ที่กำหนด
หากต้องการใช้ฟังก์ชันนี้ ผู้ดูแลระบบ FedEx หรือ ผู้ดูแลระบบ DI จะต้องสร้างโครงการเว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูง
ตัวเลือกการนำทาง
คุณสามารถเข้าถึงหน้าเว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูงได้ด้วยสองวิธี:
วิธีที่ 1: ผ่านโครงการของฉัน
- ไปที่โครงการของฉัน ซึ่งอยู่ที่แผงการนำทางด้านซ้าย
- คลิกแท็บเว็บฮุค
วิธีที่ 2: ผ่านแค็ตตาล็อก API
- ไปที่แค็ตตาล็อก API จากแผงการนำทางด้านซ้าย
- ใช้แถบค้นหาเพื่อค้นหาการติดตามสถานะแบบรวมระบบขั้นสูง หรือเลือกจากส่วนตัวกรอง
- ที่ด้านบนของการ์ดเว็บฮุค โปรดเลือกรายการใดรายการหนึ่งต่อไปนี้:
- คลิกเอกสาร → จากนั้นคลิก + จัดการเว็บฮุค
การดูโครงการการสมัครรับข้อมูลหมายเลขการติดตามสถานะแบบรวมระบบขั้นสูง
1. การเข้าถึงและการตั้งค่าส่วนบุคคลของ FedEx
- ผู้ดูแลระบบ FedEx หรือ เจ้าหน้าที่ของ FedEx จะเริ่มขั้นตอนการตั้งค่า
- ผู้ดูแลระบบที่ได้รับมอบหมายในนามของลูกค้า CSP จะสร้างโปรไฟล์องค์กร
- หมายเลขบัญชีการเรียกเก็บเงินในสหรัฐอเมริกาที่มีสิทธิ์จะถูกเพิ่มเข้ามาในระดับองค์กร โดยผู้ดูแลระบบในนามของลูกค้า
- ผู้ดูแลระบบที่ดำเนินการตั้งค่านี้จะต้องได้รับสิทธิ์ที่เหมาะสมในการจัดการการกำหนดค่าในระดับองค์กร
2. ดูเวิร์กโฟลว์สำหรับการสมัครรับข้อมูลหมายเลขการติดตาม
2.1 ดูการสมัครรับข้อมูล
- เมื่อผู้ดูแลระบบหรือตัวแทนของ FedEx สร้างโครงการแล้ว ผู้ใช้สามารถดูการติดตามสถานะแบบรวมระบบขั้นสูง – โครงการการสมัครรับข้อมูลหมายเลขการติดตามได้ภายในแดชบอร์ดของตน
2. ดูคุณสมบัติ
- ผู้ใช้สามารถสำรวจคุณสมบัติที่มีอยู่ซึ่งเกี่ยวข้องกับโครงการการสมัครรับข้อมูล เพื่อสร้างความเข้าใจและการใช้งานที่ดียิ่งขึ้นได้
คำอธิบายคุณสมบัติ
| ชื่อฟิลด์ | คำอธิบาย |
|---|---|
| หลักฐานการส่งมอบ | การยืนยันว่าพัสดุได้รับการจัดส่งเรียบร้อยแล้ว ประกอบด้วย:
|
| การแจ้งการจัดส่งโดยประมาณ | ช่วยให้ผู้รับวางแผนได้โดยการ:
|
| การติดตามกิจกรรม | อนุญาตให้เลือกหมวดหมู่กิจกรรมอย่างน้อยหนึ่งหมวดหมู่เพื่อรับการแจ้งเตือน:
|
ในหน้ารายละเอียด ข้อมูลต่อไปนี้จะปรากฏขึ้น:
| ชื่อฟิลด์ | คำอธิบาย |
|---|---|
| ชื่อโครงการเว็บฮุค | ชื่อสำหรับโครงการเว็บฮุคของคุณที่ไม่ซ้ำกันและไม่ว่างเปล่า ชื่อที่แนะนำซึ่งเป็นชื่อที่กรอกอัตโนมัติ แต่สามารถแก้ไขได้ โดยชื่อนี้จะไม่ซ้ำกับเว็บฮุคอื่น |
| URL ปลายทาง | ปลายทาง HTTPS ที่ปลอดภัยที่ FedEx จะส่งข้อมูลการติดตามกิจกรรม ข้อกำหนด:
|
| โทเค็นรักษาความปลอดภัย | ข้อมูลลับร่วมที่ใช้ในการรับรองความถูกต้องและตรวจสอบการตอบกลับของเว็บฮุคผ่าน HMAC ข้อกำหนด:
|
| ภาษาเพย์โหลด (ประเทศ) | เลือกภาษาที่ต้องการสำหรับการแปลข้อมูลการติดตามจากรายการเมนูตัวเลือก |
| ประเภทการติดตาม | เลือกวิธีการส่งข้อมูลการติดตาม:
|
| ที่อยู่อีเมล์ | ระบุที่อยู่อีเมลที่ถูกต้องเพื่อรับการแจ้งเตือน |
| ภาษาอีเมล (ประเทศ) | เลือกภาษาที่ต้องการสำหรับการแจ้งเตือนทางอีเมล หมายเหตุ: รองรับเฉพาะภาษาของสหรัฐอเมริกาเท่านั้น (เช่น en-US, es-US) |
ขั้นตอนโดยละเอียด
4. สร้างโครงการสมัครรับข้อมูล
- ใช้ขั้นตอนจากส่วนก่อนหน้า หรือดูที่คู่มือเริ่มต้นใช้งาน
5. สร้างโทเค็น OAuth
- คุณจำเป็นต้องมีโทเค็น OAuth เพื่อเรียกใช้ API
- ใช้การให้สิทธิ์อนุญาต API เพื่อสร้างโทเค็น
- โปรดดูการเตรียมเอกสารประกอบการให้สิทธิ์อนุญาต API ในแค็ตตาล็อก API สำหรับขั้นตอนโดยละเอียด
6. การเตรียมเอกสารการเข้าถึง API
- คลิกที่รายละเอียดโครงการ ในเมนูนำทางด้านซ้าย
- ที่ใต้แท็บคีย์การใช้งานจริง เลื่อนลงเพื่อค้นหาการเตรียมเอกสาร API เพื่อการสมัครรับข้อมูลหมายเลขการติดตามสถานะแบบรวมระบบขั้นสูง
ภาพรวมปลายทาง API
| ปลายทาง | วัตถุประสงค์ |
|---|---|
| การเชื่อมโยงหมายเลขการติดตาม | เพิ่มหรือลบหมายเลขการติดตามออกจากการสมัครรับข้อมูลเว็บฮุค โดยนี่จะเป็นการทำงานแบบอะซิงโครนัส ซึ่ง ID งานจะจะส่งคือให้ผ่านการตอบกลับ |
| รายละเอียดหมายเลขการติดตามงาน | ให้รายละเอียดเกี่ยวกับ ID งานนั้นๆ เช่น จำนวนหมายเลขการติดตามที่เพิ่มได้สำเร็จหรือมีกี่หมายเลขที่ยังประมวลผลอยู่ |
| สถานะหมายเลขการติดตามงาน | ส่งกลับข้อมูลสรุปของงานทั้งหมดที่กำลังดำเนินการอยู่ |
ใช้โทเค็น OAuth จากขั้นตอนที่ 2 ร่วมกับปลายทางการเชื่อมโยงหมายเลขการติดตาม เพื่อเพิ่มหมายเลขการติดตามไปยังเว็บฮุคของคุณ
กฎการตรวจสอบ
- ชื่อเว็บฮุคต้องไม่ซ้ำกัน
- URL ปลายทางต้องเป็นไปตามรูปแบบไวยากรณ์มาตรฐาน
- ต้องกรอกข้อมูลในช่องที่ต้องระบุทั้งหมด
- ต้องมีหมายเลขบัญชีการจัดส่งของ FedEx ที่ถูกต้องอย่างน้อยหนึ่งหมายเลข
ผลลัพธ์การตรวจสอบ
| สถานะ | รายละเอียด |
|---|---|
| สำเร็จ | ข้อความยืนยันจะปรากฏขึ้น: “<> สร้างเรียบร้อยแล้ว การเปลี่ยนแปลงอาจใช้เวลาถึง 10 นาทีจึงจะมีผล” |
| ไม่สำเร็จ | หาก FedEx ได้รับการตอบกลับอื่นใดนอกเหนือจาก 200 (ตกลง) หรือ 202 (ยอมรับ) การตรวจสอบ URL ปลายทางของเว็บฮุคจะถือว่าล้มเหลว |
Response