Bài viết này giải thích cách cấu hình Webhook bằng Gelato API để nhận thông báo trong ứng dụng của bạn mỗi khi có sự kiện xảy ra với đơn hàng.
Cấu hình Webhook
Gelato API cung cấp tính năng Webhook mạnh mẽ, giúp bạn nắm bắt các sự kiện quan trọng liên quan đến đơn hàng. Để cấu hình Webhook, làm theo các bước sau:
Truy cập Trang quản lý Gelato và đi đến phần Webhooks. Khu vực này là trung tâm giúp bạn quản lý các cấu hình webhook của mình ở một nơi.
Nhấp vào nút "Thêm Webhook" để bắt đầu tạo webhook mới. Hành động này sẽ mở một biểu mẫu cấu hình nơi bạn có thể chỉ định chi tiết cho webhook của mình.
Cung cấp URL của endpoint trong ứng dụng sẽ nhận thông báo Webhook. Đảm bảo URL này có thể truy cập công khai và được cấu hình đúng để xử lý yêu cầu HTTP đến. Chọn phương thức HTTP, GET hoặc POST, phù hợp với yêu cầu của ứng dụng. Chọn các loại sự kiện bạn muốn đăng ký. Gelato cung cấp danh sách đầy đủ các loại sự kiện như tạo đơn hàng, cập nhật đơn hàng và thông báo vận chuyển, giúp bạn kiểm soát chi tiết các thông báo nhận được. Để xem mô tả chi tiết cho từng loại sự kiện, xem thêm trong Tài liệu API.
Thiết lập ủy quyền cho Webhook để tăng cường bảo mật và đảm bảo thông báo đến từ nguồn đáng tin cậy. Chọn loại ủy quyền phù hợp, như HTTP headers hoặc query parameters. Cung cấp thông tin xác thực cần thiết, chẳng hạn như API key hoặc token, vào các trường được chỉ định. Để xác nhận cấu hình Webhook và đảm bảo thông báo được gửi thành công, hãy gửi một thông báo thử đến endpoint đã chỉ định. Bước này giúp phát hiện và xử lý các vấn đề tiềm ẩn trước khi Webhook được triển khai trên môi trường thật.
Quản lý Webhook
Khi đã cấu hình xong Webhook, bạn có thể dễ dàng quản lý chúng từ Trang quản lý của Gelato. Phần Webhooks cung cấp tổng quan đầy đủ về tất cả Webhook của bạn, cho phép bạn thực hiện các thao tác như:
Chỉnh sửa Webhook hiện có: Tùy chỉnh cấu hình Webhook bất cứ lúc nào để phù hợp với nhu cầu đang thay đổi. Cập nhật URL thông báo, đăng ký sự kiện hoặc thông tin ủy quyền khi cần.
Xóa webhook: Xóa các webhook không còn cần thiết để giữ cấu hình webhook gọn gàng và ngăn nắp. Khi xóa một webhook, các thông báo sẽ không còn được gửi đến endpoint liên kết.
Để hiểu sâu hơn về Gelato API, bao gồm thông tin chi tiết về các sự kiện Webhook và payload, vui lòng xem tài liệu kỹ thuật đầy đủ của chúng tôi.
Để truy cập mục Webhooks trong tài khoản Gelato, bạn có thể đi thẳng tới Developer > Webooks từ menu bên trái.