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