Fedex Logo

สร้าง
เว็บฮุค จัดการเว็บฮุค

กฎการดำเนินธุรกิจและกระบวนการตรวจสอบ


  • คุณไม่สามารถใช้หมายเลขบัญชีการจัดส่งเดียวกับการติดตามสถานะแบบรวมระบบขั้นสูงหลายรายการได้
  • URL ปลายทางที่ลูกค้าสร้างจะต้อง:
    • เป็นโฮสต์ HTTP
    • ตอบโต้กับคำร้องขอ POST และวิเคราะห์เพย์โหลด JSON ได้
    • ขีดจำกัดตัวอักษร 200 อักขระ
    • URL ของคุณจะถูกบล็อกหากประกอบด้วย:
      • ที่อยู่ IP RFC1918
      • fedex.com หรือโดเมนย่อยใดๆ
      • ที่อยู่ IP ใน URL (รวมถึง localhost, 127.0.0.1)

 

  • การรักษาความปลอดภัยการติดตามสถานะแบบรวมระบบขั้นสูง รองรับเฉพาะการเชื่อมต่อ HTTPS ที่ใช้ TLS (SSL) 1.2 หรือเวอร์ชันโปรโตคอลที่สูงกว่าที่กำหนดค่าด้วยใบรับรองจากผู้ออกใบรับรอง (CA) ที่ถูกต้องเท่านั้น เพิ่มที่อยู่ IP ต่อไปนี้เพื่อรับอัปเดตจากเซิร์ฟเวอร์ FedEx โดยปราศจากการรบกวน:
    Prod

         ไคลเอ็นต์สามารถอนุญาต: “nat.fxconnect.eastus2.heap-prod.fedex.io”

         โดยใช้ CIDR "20.65.16.22/31"
  • บางครั้งลูกค้าอาจได้รับอัปเดตการติดตามกิจกรรมที่ไม่เรียงตามลำดับ และต้องดูที่การประทับเวลาสแกนกิจกรรมเพื่อดูลำดับที่ถูกต้อง
  • การลบบัญชีใน FedEx Developer Portal:
    • ผู้ใช้/ลูกค้าไม่สามารถลบบัญชีได้:
      1. หากบัญชีเชื่อมโยงกับการติดตามสถานะแบบรวมระบบขั้นสูงใดๆ ที่ใช้งานอยู่
      2. หากบัญชีพร้อมใช้งานหรือเชื่อมโยงไว้กับโครงการและ
      3. หากเป็นบัญชีเดียวในโครงการ/การติดตามสถานะแบบรวมระบบขั้นสูง
        หมายเหตุ: ผู้ใช้/ลูกค้าจำเป็นต้องลบบัญชีออกจากโครงการ/การติดตามสถานะแบบรวมระบบขั้นสูงก่อน จากนั้นให้ลบออกจากองค์กร
    • ผู้ใช้/ลูกค้าสามารถลบบัญชีได้:
      1. บัญชีจะต้องเป็นขององค์กรเดียวกัน
      2. ผู้ใช้/ลูกค้าจะต้องเป็นผู้ดูแลระบบจึงจะลบบัญชีออกจากองค์กรได้

ข้อจำกัดทั่วไป

  • การจัดส่งของลูกค้าทั้งหมดที่เกี่ยวข้องกับหมายเลขบัญชี FedEx 9 หลักของบริษัทที่ดำเนินการ ได้แก่ FedEx Express®, FedEx Ground® และ FedEx Ground® Economy (เดิมเรียกว่า FedEx SmartPost®) รวมอยู่ในขอบเขตทั้งหมดไม่ว่าจะเป็นปลายทางหรือต้นทาง (ขาเข้า ขาออก ระหว่างประเทศ ภายในประเทศ ฯลฯ)
  • เว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูงรองรับเฉพาะบัญชีที่เปิดใช้งานสำหรับองค์กร/พัสดุ 9 หลักเท่านั้น บัญชีองค์กรช่วยให้สามารถสร้างการจัดส่งที่เกี่ยวข้องกับบริษัทที่ดำเนินงานของ FedEx ทั้งหมด รวมถึง FedEx Express และ FedEx Ground

    • หมายเหตุ: ไม่รองรับเฉพาะบัญชี LTL Freight 9 หลักเท่านั้น หากคุณต้องการเพิ่มบัญชี LTL Freight คุณต้องติดต่อฝ่ายบริการลูกค้าเพื่อย้ายบัญชี LTL ไปยังบัญชีองค์กร
  • ลูกค้าจะต้องจัดการลำดับการติดตามกิจกรรมการจัดส่งที่ได้รับ
  • ระบบจะส่งการแจ้งเตือนทางอีเมลโดยอัตโนมัติเมื่อใดก็ตามที่มีกิจกรรมใดๆ (บันทึก/ล้มเหลว/สร้าง/อัปเดต/ยกเลิก/ลบ) บนเว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูงที่สมัครไว้
  • การแปล:
    • การแปลเพย์โหลดการติดตามรองรับ 41 ภาษา (ตามท้องถิ่น)(เร็วๆ นี้)
      คลิกที่นี่เพื่อดูรายการภาษาที่รองรับ
    • ขณะนี้ รองรับการแปลเพย์โหลดการติดตามในภาษาอังกฤษ (สหรัฐอเมริกา) แล้ว
    • การแปลการแจ้งเตือนทางอีเมลมีให้บริการในภาษาที่ภูมิภาคสหรัฐอเมริการองรับเท่านั้น (ตามท้องถิ่น: en-US, es-US)

 


บทบาทผู้ใช้ใน FedEx Developer Portal:


ภายใน FedEx Developer Portal คุณจะสามารถใช้งานฟังก์ชันต่างๆ ได้ตามบทบาทที่คุณตั้งค่าไว้
โปรดดู คู่มือการดูแลระบบขององค์กร เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับ FedEx Developer Portal

กระบวนการตรวจสอบการติดตามสถานะแบบรวมระบบขั้นสูง 

MAC/HMAC คืออะไร และถูกใช้งานในกระบวนการตรวจสอบอย่างไร

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

กลไก MAC ที่อิงจากฟังก์ชันแฮชเข้ารหัสลับนั้นเรียกว่า HMAC คุณสามารถใช้ HMAC กับฟังก์ชันแฮชเข้ารหัสลับอื่น เช่น SHA256 ควบคู่กับคีย์ลับร่วมได้ HMAC ได้รับการระบุใน RFC 2104 เว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูงของ FedEx จะใช้ HMAC SHA256

SHA256 (โทเค็นรักษาความปลอดภัย + เพย์โหลด) =  fdx-signature ที่เข้ารหัสฐาน 64 ที่เป็นส่วนหนึ่งของส่วนหัวเพย์โหลด

ตัวอย่าง (โค้ดจำลองบางส่วนเพื่อแสดงตัวอย่างแฮชของ HMAC SHA256):

  • ขั้นตอนแรก เปิดใช้ MAC โดยใช้อัลกอริธึม HmacSHA256 และใช้โทเค็นรักษาความปลอดภัยเป็นคีย์ลับ
  • จากนั้นให้จบขั้นตอนการทำงาน MAC โดยการเข้ารหัสเพย์โหลดคำร้องขอที่ส่งโดย FedEx ด้วย hex
  • แฮชสุดท้ายนี้ควรตรงกับค่าที่อยู่ในส่วนหัว fdx-signature ในการแจ้งเตือนแบบพุชที่ส่งโดย FedEx

Mac mac = Mac.getInstance("HmacSHA256"); 

mac.init(new SecretKeySpec(secureToken.getBytes(), "HmacSHA256")); 

return new String(Base 64 encoded(mac.doFinal(payLoad.getBytes()))); 

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

 

การคำนวณความล่าช้า

 

เวลาในการสร้างกิจกรรมจะแสดงเวลาที่กิจกรรมเกิดขึ้นจริงภายในเครือข่าย
เว็บฮุคหรือระบบอื่นๆ จะไม่สามารถประมวลผลหรือส่งข้อมูลได้จนกว่าจะมีการเข้าสู่ระบบกิจกรรม (ระบุโดยการลงเวลาสร้างข้อความ)

คำแนะนำ

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

 

กฎการตรวจสอบ: 

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

      ตัวอย่างข้อความยืนยัน: สร้าง <<Advanced Integrated Visibility webhook name>> เรียบร้อยแล้ว การเปลี่ยนแปลงอาจใช้เวลาถึง 10 นาทีจึงจะมีผล

  • การตรวจสอบที่ไม่สำเร็จ/ล้มเหลว:
    • หาก FedEx ได้รับการตอบกลับอื่นใดนอกเหนือจาก 200 (ตกลง) หรือ 202 (ยอมรับ) การตรวจสอบ URL ปลายทางของเว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูงจะถือว่าล้มเหลว

ตัวอย่างกฎการดำเนินธุรกิจและกระบวนการตรวจสอบ


  • คุณไม่สามารถใช้หมายเลขบัญชีการจัดส่งเดียวกับการติดตามสถานะแบบรวมระบบขั้นสูงหลายรายการได้
  • URL ปลายทางที่ลูกค้าสร้างจะต้อง:
    • เป็นโฮสต์ HTTP
    • ตอบโต้กับคำร้องขอ POST และวิเคราะห์เพย์โหลด JSON ได้
    • ขีดจำกัดตัวอักษร 200 อักขระ
    • URL ของคุณจะถูกบล็อกหากประกอบด้วย:
      • ที่อยู่ IP RFC1918
      • fedex.com หรือโดเมนย่อยใดๆ
      • ที่อยู่ IP ใน URL (รวมถึง localhost, 127.0.0.1)

 

  • การรักษาความปลอดภัยการติดตามสถานะแบบรวมระบบขั้นสูง รองรับเฉพาะการเชื่อมต่อ HTTPS ที่ใช้ TLS (SSL) 1.2 หรือเวอร์ชันโปรโตคอลที่สูงกว่าที่กำหนดค่าด้วยใบรับรองจากผู้ออกใบรับรอง (CA) ที่ถูกต้องเท่านั้น เพิ่มที่อยู่ IP ต่อไปนี้เพื่อรับอัปเดตจากเซิร์ฟเวอร์ FedEx โดยปราศจากการรบกวน:
    Prod

         ไคลเอ็นต์สามารถอนุญาต: “nat.fxconnect.eastus2.heap-prod.fedex.io”

         โดยใช้ CIDR "20.65.16.22/31"
  • บางครั้งลูกค้าอาจได้รับอัปเดตการติดตามกิจกรรมที่ไม่เรียงตามลำดับ และต้องดูที่การประทับเวลาสแกนกิจกรรมเพื่อดูลำดับที่ถูกต้อง
  • การลบบัญชีใน FedEx Developer Portal:
    • ผู้ใช้/ลูกค้าไม่สามารถลบบัญชีได้:
      1. หากบัญชีเชื่อมโยงกับการติดตามสถานะแบบรวมระบบขั้นสูงใดๆ ที่ใช้งานอยู่
      2. หากบัญชีพร้อมใช้งานหรือเชื่อมโยงไว้กับโครงการและ
      3. หากเป็นบัญชีเดียวในโครงการ/การติดตามสถานะแบบรวมระบบขั้นสูง
        หมายเหตุ: ผู้ใช้/ลูกค้าจำเป็นต้องลบบัญชีออกจากโครงการ/การติดตามสถานะแบบรวมระบบขั้นสูงก่อน จากนั้นให้ลบออกจากองค์กร
    • ผู้ใช้/ลูกค้าสามารถลบบัญชีได้:
      1. บัญชีจะต้องเป็นขององค์กรเดียวกัน
      2. ผู้ใช้/ลูกค้าจะต้องเป็นผู้ดูแลระบบจึงจะลบบัญชีออกจากองค์กรได้
CLOSE

Response

Copy