POST Cập Nhật Kết Quả Mở Hộp Bí Ẩn (Blind Box)
Cập Nhật Kết Quả Mở Hộp Bí Ẩn (Blind Box) Shop Scope bắt buộc: seller.order.info Sau khi người bán hoàn tất việc mở hộp bí ẩn trong phòng live, kết quả mở hộp bí ẩn sẽ được truyền trở lại nền tảng, sau đó người dùng có thể xem kết quả mở hộp trong chi tiết đơn hàng Phiên bản 202605
POST/order/202605/orders/blind_box_result/callback
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 người bán 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 người bán. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng dùng key cụ thể được cấp 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 yêu cầu API đến 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 dùng cho tất cả các yêu cầu API. Nhà phát triển có thể dùng nó để chuyển đổi sang giờ địa phương. |
| shop_cipher Required | string | 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 |
|---|---|---|
| main_order_id | string | Mã định danh duy nhất cho một đơn hàng TikTok Shop. |
| blind_box_results | []object | Kết quả mở hộp cho các line item thuộc đơn hàng. |
| blind_batch_box_results | []object | Kết quả mở hộp theo lô cho các line item thuộc đơn hàng. |
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 trả về trong phản hồi API. |
| message | string | Thông báo thành công hoặc thất bại trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Nhật ký yêu cầu |
| 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 | | --- | --- | | 10007002 | Đơn hàng hiện tại không phải là đơn hộp bí ẩn của người bán. | | 10007006 | Tham số không hợp lệ, vui lòng kiểm tra rằng tất cả các tham số bắt buộc đều hợp lệ. | | 10007008 | Chưa lấy được thông tin đơn hàng. | | 10007109 | Cập nhật đơn hàng thất bại, vui lòng liên hệ nền tảng. | | 10007143 | Chưa lấy được thông tin sản phẩm. Vui lòng xác nhận xem thông tin sản phẩm đã được đồng bộ lên TikTok Shop hay chưa. | | 10007999 | Lỗi hệ thống, vui lòng liên hệ nền tảng. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext