POST Search Activities
Tìm kiếm hoạt động Shop Scope yêu cầu: seller.promotion.info Lấy danh sách các hoạt động khuyến mãi giảm giá sản phẩm hoặc flash deal. Đối với hoạt động coupon, hãy dùng Search Coupons
. Phiên bản 202309
POST/promotion/202309/activities/search
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được cho phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của người bán 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 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 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 giá trị này để 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 |
|---|---|---|
| status | string | Trạng thái hoạt động.Các giá trị có thể có:- DRAFT: Các hoạt động khuyến mãi ở trạng thái này không hiển thị với người dùng TikTok.- NOT_START: Các hoạt động khuyến mãi ở trạng thái này không hiển thị với người dùng TikTok cho đến thời điểm bắt đầu hoạt động đã thiết lập.- ONGOING: Các hoạt động khuyến mãi ở trạng thái này hiển thị với người dùng TikTok.- EXPIRED: Các hoạt động khuyến mãi ở trạng thái này không hiển thị với người dùng TikTok vì đã hết hạn.- DEACTIVATED: Hoạt động đã bị người bán hủy kích hoạt và không hiển thị với người dùng TikTok.- NOT_EFFECTIVE: Hoạt động bị nền tảng chấm dứt và không hiển thị với người dùng TikTok. |
| activity_title | string | Từ khóa tiêu đề hoạt động. Không hỗ trợ khớp mờ. |
| page_size | int | Kích thước trang. Phạm vi là [0, 100]. Mặc định là 50. |
| page_token | string | Chỉ định giá trị cho trang. Dùng "" cho trang đầu tiên. |
| activity_type | string | Kiểu hoạt động. Nếu activity_type không được truyền, trả về các hoạt động thuộc tất cả các kiểu. Các giá trị có thể có:Kiểu hoạt động.Các giá trị có thể có:- FIXED_PRICE- DIRECT_DISCOUNT- FLASHSALE- SHIPPING_DISCOUNT- BUY_MORE_SAVE_MORE |
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
View common error codes
| Code | Message | | --- | --- | | 17029001 | Invalid parameters | | 17029055 | Request Timeout | | 17029059 | page_token + page_size must be less than 10000. | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext