PUT Cập nhật Shop Webhook

Cập nhật Shop Webhook Shop Scope bắt buộc: seller.authorization.info Cập nhật URL webhook của shop cho một event topic cụ thể. Phiên bản 202309

PUT/event/202309/webhooks

Request

Header

Properties	Type	Description
content-type Required	string	Kiểu được phép: application/json
x-tts-access-token Required	string	Giá trị access_token của seller lấy từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của seller.

Query

Properties	Type	Description
app_key Required	string	Mỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn.
sign Required	string	Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi các yêu cầu API tới TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi.
timestamp Required	int	Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các yêu cầu API. Lập trình viên có thể dùng để chuyển đổi sang giờ địa phương.
shop_cipher Required	string	Sử dụng thuộc tính này để truyền thông tin shop khi gọi API. Việc không truyền đúng giá trị khi gọi API cho các shop xuyên biên giới sẽ trả về phản hồi không chính xác. Lấy bằng API Get Authorization Shop

Body

Properties	Type	Description
address Required	string	URL webhook được sử dụng để nhận dữ liệu sự kiện. Độ dài tối đa: 255 ký tự
event_type Required	string	Topic của sự kiện webhook.Các giá trị có thể:- ORDER_STATUS_CHANGE: Kích hoạt mỗi khi trạng thái đơn hàng được cập nhật, từ lúc đặt đơn mới cho đến tất cả các thay đổi trạng thái tiếp theo. Xem Order Status change.- RECIPIENT_ADDRESS_UPDATE: Kích hoạt khi địa chỉ người nhận được cập nhật. Xem Receipient address update.- PACKAGE_UPDATE: Kích hoạt khi một kiện hàng được cập nhật (ví dụ: gộp, tách, hoặc thay đổi địa chỉ). Xem Package update.- PRODUCT_STATUS_CHANGE: Kích hoạt khi kết quả kiểm duyệt sản phẩm được cập nhật. Xem Product status change.- SELLER_DEAUTHORIZATION: Kích hoạt khi một seller bị hủy ủy quyền để thông báo cho lập trình viên và tránh hiểu nhầm về các vấn đề ủy quyền của nền tảng. Xem Seller deauthorization.- UPCOMING_AUTHORIZATION_EXPIRATION: Kích hoạt 30 ngày trước khi ủy quyền hết hạn, với thông báo hàng ngày lúc 0:00 cho đến khi hoàn tất việc tái ủy quyền. Xem Upcoming authorization expiration.- CANCELLATION_STATUS_CHANGE: Kích hoạt khi trạng thái hủy của một đơn hàng thay đổi. Xem Cancellation status change.- RETURN_STATUS_CHANGE: Kích hoạt khi trạng thái trả hàng của một đơn hàng thay đổi. Xem Return status change.- NEW_CONVERSATION: Kích hoạt khi một nhân viên chăm sóc khách hàng tham gia hoặc rời khỏi một cuộc hội thoại. Xem New conversation.- NEW_MESSAGE: Kích hoạt khi một tin nhắn mới được gửi trong cuộc hội thoại chăm sóc khách hàng. Xem New Message.- PRODUCT_INFORMATION_CHANGE: Kích hoạt khi các thay đổi về tiêu đề, mô tả, ảnh chính, hoặc thuộc tính của sản phẩm có hiệu lực. Xem Product information change.- PRODUCT_CREATION: Kích hoạt khi một sản phẩm mới được tạo. Xem Product creation.- PRODUCT_CATEGORY_CHANGE: Kích hoạt khi danh mục của một sản phẩm bị thay đổi. Xem Product category change.- NEW_MESSAGE_LISTENER: Kích hoạt khi một creator gửi tin nhắn cho seller. Xem New message listener.- INVOICE_STATUS_CHANGE: Kích hoạt khi trạng thái tải lên hóa đơn thay đổi sau khi sử dụng endpoint POST Upload Invoice. Xem Invoice Status Change.- PRODUCT_AUDIT_STATUS_CHANGE: Kích hoạt khi trạng thái kiểm duyệt sản phẩm thay đổi. Xem Product audit status change.- REVERSE_STATUS_UPDATE: Kích hoạt khi người mua đưa ra yêu cầu hủy, chỉ hoàn tiền, hoặc trả hàng & hoàn tiền cần seller chấp nhận hoặc từ chối. Xem Reverse Status Update.

Example

CurlGoNode.jsJavaEnable word wrap

Response Parameters

Properties	Type	Description
code	int	Mã trạng thái thành công hoặc thất bại được trả về trong phản hồi API.
message	string	Thông báo thành công hoặc thất bại được trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong message.
request_id	string	Log của request
data	object	Thông tin trả về cụ thể

Example

JSONEnable word wrap

Error Code

Xem các mã lỗi thường gặp

| Code | Message | | --- | --- | | Trống. Không có mã lỗi logic nghiệp vụ. |

Nội dung này có hữu ích không?Hữu ích

Không hữu ích

PreviousNext