Fedex Logo

Kiểm thử webhook


Bạn có thể sử dụng tính năng Kiểm thử URL webhook để kiểm tra loại dữ liệu theo dõi được trả về URL đích (máy chủ tiếp nhận/lắng nghe). Việc này giúp xác thực URL và dữ liệu trả về trước khi tạo webhook Advanced Integrated Visibility.

Điều hướng:

Dưới đây là những cách di chuyển đến Bảng điều khiển sandbox Kiểm thử URL webhook:

  • Dự án của tôi (ở Bảng điều hướng bên trái) -> tab Advanced Integrated Visibility -> nút Kiểm thử URL webhook -> trong Bảng điều khiển sandbox, nhấp vào Dùng thử Advanced Integrated Visibility này
  • Danh mục API (ở Bảng điều hướng bên trái) -> tìm kiếm Advanced Integrated Visibility/nhấp vào Advanced Integrated Visibility trong thẻ BỘ LỌC -> Advanced Integrated Visibility:
    1. -> Tổng quan -> nút Tài liệu -> nhấp vào Dùng thử Advanced Integrated Visibility này trong Bảng điều khiển sandbox.
    2. -> Tài liệu -> nhấp vào Dùng thử Advanced Integrated Visibility này trong Bảng điều khiển sandbox.

Các bước:

Dưới đây là các bước để sử dụng chức năng Kiểm thử URL webhook:

  1. Nhấp vào nút Kiểm thử URL webhook.
  2. Nhập các thông số Thử nghiệm sau đây:
    Tên trường Mô tả

    URL đích

    Đây là URL nhận phần tải/dữ liệu sự kiện Theo dõi.

    • Khách hàng phải cung cấp URL đích hợp lệ và có thể truy cập được.
    • URL đích bạn cung cấp phải ở định dạng cú pháp chuẩn hóa (URL https an toàn).

    Mã thông báo bảo mật

    Được dùng làm khóa bí mật chung để xác thực và xác nhận phản hồi của webhook Advanced Integrated Visibility.

    • Giá trị mã thông báo phải có độ dài tối thiểu 26 ký tự và tối đa 100 ký tự.
    • Cần có ít nhất 1 ký tự viết hoa, 1 ký tự viết thường và 1 ký tự số.
    • Mã thông báo bảo mật sẽ được dùng để tạo chữ ký Mã xác thực tin nhắn dựa trên hàm băm (HMAC) để xác thực phản hồi.

    Ngôn ngữ trọng tải

    Chọn ngôn ngữ ưu tiên cho bản dịch dữ liệu theo dõi trong danh sách thả xuống. Sáu ngôn ngữ ví dụ được cung cấp bao gồm:

    • Tiếng Anh (Mỹ)(Mặc định)

    Loại theo dõi

    Chọn loại phản hồi bạn cần nhận dữ liệu theo dõi.

    • Phản hồi theo dõi chi tiết (Loại phản hồi bao gồm dữ liệu theo dõi bảo mật cung cấp toàn bộ lịch sử sự kiện).(Mặc định)
    • Phản hồi theo dõi từng sự kiện (Loại phản hồi bao gồm dữ liệu theo dõi bảo mật chỉ cung cấp thông tin về sự kiện gần đây nhất).(Sắp ra mắt)

    Sự kiện theo dõi

    Chọn một danh mục cấp cao hơn để nhận thông báo qua email liên quan đến sự kiện của lô hàng trong vòng đời gói hàng. Dưới đây là các danh mục cấp cao hơn:

    • Vận chuyển
    • Đang vận chuyển
    • Giao hàng
    • Ngoại lệ
    • Giao hàng ước tính

    Sự kiện trạng thái

    Sự kiện theo dõi trong vòng đời gói hàng. Chọn một trong các sự kiện theo dõi cần nhận thông tin. Dưới đây là 10 mẫu sự kiện trạng thái hiện có:

    1. Đã nhận hàng
    2. Đang vận chuyển
    3. Đã giao hàng
    4. Ngoại lệ giao hàng

     

    Lưu ý: Các giá trị của trường "Sự kiện trạng thái" sẽ được điền dựa trên "Danh mục sự kiện theo dõi" đã chọn. Hãy tham khảo bảng sau đây để tìm hiểu thêm về "Danh mục sự kiện theo dõi" và "Sự kiện trạng thái" tương ứng.

     

    Danh mục sự kiện trạng thái Sự kiện trạng thái

    Vận chuyển

    • Đã nhận hàng

    Đang vận chuyển

    • Đang vận chuyển

    Giao hàng

    • Đã giao hàng

    Ngoại lệ

    • Ngoại lệ giao hàng

    Ngày giao hàng ước tính(Sắp ra mắt)

    • Ngày giao hàng ước tính (EDD)
    • Khung thời gian giao hàng ước tính (EDTW)

     

  3. Đánh dấu vào ô Thỏa thuận cấp phép FedEx Developer Portal (FDPLA) để Ký/Chấp nhận Thỏa thuận cấp phép.
  4. Nhấp vào nút GỬI để xem kết quả thử nghiệm.


Phản hồi:

Dưới đây là các thông số phản hồi trong Sandbox:

  • Nội dung – Phần nội dung chứa các thông số phản hồi trong tab URL webhook thử nghiệm trong Bảng điều khiển sandbox.
  • Trạng thái – Phần này trong tab Kết quả thử nghiệm cung cấp cho bạn trạng thái yêu cầu được xử lý.
  • Mẫu thông báo thành công:
    Thành công
    Đã gửi thành công chi tiết về sự kiện theo dõi Kiểm thử Advanced Integrated Visibility.

 

Sandbox Console

Test Parameters

Add in test parameters and push to check if the URL receives test event data from Webhooks API calls.

The destination URL is where we will send you authentication codes and messages as well as Advanced Integrated Visibility payload notifications. Only HTTPS connections using TLS (SSL) 1.2 or higher protocol version that is configured with a certificate from a valid certificate authority is supported. (Character limit: 200)

The following are not valid destination URLs:
• All RFC1918 IP space<br>
• All fedex.com and its sub domain<br>
• IP addresses in the URL (including localhost, 127.0.0.1)

Security Token should be a minimum length of 25 characters and a maximum length of 100 characters, 1 upper case, 1 lower case, 1 numeric character.

Example: Y1F6OiVUQW2JPSElmRE9U0IY5

Payload languageThe language in which you will receive the tracking data. Currently payload language is only available in English
View a full list of languages

Currently detailed tracking is the only available tracking type.

Detailed Tracking
Detailed Tracking Response consists of secured data with the entire history of events.

Event-specific Tracking (coming soon)
Event-specific Tracking Response consists of secure tracking data with only the most recent event information.

Tracking event
These are different categories of tracking events in the shipment life cycle. select one or more of these categories. Then when an event in that category happens, we will trigger webhook notifications and send you a tracking payload response.

Select a tracking event in the package lifecycle to include

Copy copied

Status

Success

Test webhook tracking event details delivered successfully

Error

Test webhook tracking event details delivery failed

Mẫu thông báo thành công

Nếu tác vụ gửi sự kiện thử nghiệm không thành công, TRẠNG THÁI sẽ hiển thị là Lỗi trong tab Kết quả thử nghiệm, với mã lỗi và thông báo lỗi tương ứng.

Mẫu thông báo lỗi:
Mã lỗi:<<mã lỗi>>
Không gửi được chi tiết về sự kiện theo dõi Kiểm thử Advanced Integrated Visibility.

Mẫu thông báo lỗi

Quy tắc xác thực:

  • URL Advanced Integrated Visibility phải ở định dạng Cú pháp chuẩn hóa.
  • Tất cả các trường bắt buộc cho việc kiểm thử URL Advanced Integrated Visibility không được để trống.
  • Đối với tác vụ xác thực Thành công:
    • FedEx sẽ gửi yêu cầu kèm theo mẫu JSON về sự kiện.
    • Lưu ý: URL đích của Advanced Integrated Visibility sẽ phản hồi đến FedEx với mã trạng thái HTTP là 200 (OK).
  • Đối với tác vụ xác thực Không thành công/Thất bại:
    • Nếu FedEx nhận được phản hồi không phải là 200 (OK), thì tác vụ xác thực URL đích của Advanced Integrated Visibility sẽ được coi là thất bại.
    • FedEx sẽ hiển thị mã lỗi và thông báo lỗi trong tab Kết quả thử nghiệm

Công cụ tính toán phần tải dữ liệu

Công cụ tính toán phần tải dữ liệu được thiết kế để giúp người đăng ký ước tính khối lượng dữ liệu được tạo qua hoạt động của webhook. Công cụ này mang đến khả năng quan sát quy mô phần tải hằng ngày, số lượng lô hàng và sự kiện theo dõi, giúp khách hàng có cơ sở đầy đủ đề quyết định về việc sử dụng dữ liệu và lập kế hoạch tích hợp.

Sử dụng công cụ tính toán

Người dùng có thể nhập các thông số sau:

  • Số lượng lô hàng
  • Số sự kiện trên mỗi lô hàng (mặc định: 5)
  • Khối lượng phần tải hằng ngày (được tính tự động)

Dựa trên các dữ liệu đầu vào này, công cụ tính toán sẽ hiển thị linh hoạt:

  •  Tổng số sự kiện theo dõi
  •  Phần tải hằng ngày
  •  Tổng dung lượng dữ liệu ước tính

Ghi chú thông tin:

  •  Số sự kiện trên mỗi lô hàng được đặt mặc định là 5. Giá trị này là dựa trên mức trung bình 17 – 18 sự kiện trên mỗi lô hàng và lịch trình giao hàng điển hình từ 1 – 7 ngày, tùy theo loại dịch vụ, hãng vận tải và nơi nhận hàng. Thời gian giao hàng trung bình được giả định là 3 ngày. Lưu ý: Người dùng có thể chỉnh sửa giá trị này.
  •  Khối lượng phần tải hằng ngày được tính bằng: Số lượng lô hàng × Số sự kiện trên mỗi lô hàng (mặc định: 5)
  •  Người dùng chỉ cần nhập Số lượng lô hàng và nhấp vào "TÍNH TOÁN" để tạo kết quả. Các giá trị khác được lấy mặc định hoặc được tính tự động.

Tuyên bố miễn trừ trách nhiệm: Mọi giá trị do công cụ tính toán cung cấp đều là giá trị gần đúng và chỉ nhằm mục đích lập kế hoạch.

Number of Shipments
Events per Shipment (default 5)
Daily Payload Volume (events per day)



Note: Displayed values are approximations and may not reflect exact usage metrics.
CLOSE

Response

Copy