Sandbox Console
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:
- -> 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.
- -> 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:
- Nhấp vào nút Kiểm thử URL webhook.
- 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ó:
- Đã nhận hàng
- Đang vận chuyển
- Đã giao hàng
- 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)
- Đá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.
- 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.
Status
Success
Test webhook tracking event details delivered successfully
Error
Test webhook tracking event details delivery failed
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.
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.
Response