POST Search Coupons
Tìm kiếm Coupon Shop Scope bắt buộc: seller.promotion.infohoặc seller.customer_service Sử dụng API này để lấy danh sách coupon, được thu hẹp thêm dựa trên các tham số tìm kiếm. Các coupon được tạo trong Seller Center hoặc Seller App. Để biết thêm chi tiết về một coupon cụ thể, hãy sử dụng GET Coupon. Phiên bản 202406
POST/promotion/202406/coupons/search
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được cho phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của seller 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 yêu cầu API đến TTS, bạn phải ký chúng để TTS có thể xác định 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. Nhà phát triển có thể dùng để chuyển đổi sang giờ địa phương. |
| page_token | string | Con trỏ trang. Bỏ qua tham số này sẽ trả về trang kết quả đầu tiên. |
| page_size | int | Số lượng coupon được trả về trong một trang kết quả. Phạm vi là [1, 100], với giá trị mặc định là 50. |
| shop_cipher Required | string | Sử dụng thuộc tính này để truyền thông tin shop khi yêu cầu API. Việc không truyền đúng giá trị khi yêu cầu API đối với 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 khuyến mãi của coupon.Values:- NOT_START: Chưa khả dụng với người dùng TikTok cho đến thời gian bắt đầu được cấu hình của coupon.- ONGOING: Khả dụng với người dùng TikTok.- EXPIRED: Không khả dụng với người dùng TikTok vì đã hết hạn.- DEACTIVATED: Bị seller hủy kích hoạt và không khả dụng với người dùng TikTok. |
| title_keyword | string | Từ khóa trong tiêu đề coupon để tìm kiếm. Phạm vi của độ dài là (0, 100]. Không hỗ trợ khớp mờ. |
| display_type | []string | Loại hiển thị của coupon.Values:- REGULAR: Coupon thông thường được hiển thị cho người dùng TikTok trên tất cả các vị trí hiển thị có sẵn trong TTS, bao gồm PLP, PDP, TikTok Videos, LIVE Rooms, Creator Showcases, và có thể được chia sẻ qua tin nhắn tức thời của TTS Customer Support. Bao gồm các coupon nhắm đến các phân khúc khách hàng được chọn.- LIVE: Coupon chỉ được hiển thị cho người dùng TikTok trong LIVE Rooms.- CREATOR_EXCLUSIVE: Coupon có thể được nhận thông qua các kênh hiển thị của creator được chỉ định, chẳng hạn như LIVE Rooms của họ, và Creator Showcase của họ.- CHAT: Coupon độc quyền có thể được gửi cho khách hàng qua tin nhắn chat của TTS customer support, nhưng không được hiển thị ở các vị trí hiển thị khác.- PROMO_CODE: Promo code không có vị trí hiển thị riêng trên TikTok, nhưng có thể được chia sẻ với khách hàng trong LIVE, trong TikTok video, hoặc các nền tảng mạng xã hội khác. Chúng có thể được nhận bằng cách khách hàng nhập mã nhận tại bước thanh toán hoặc bằng cách khách hàng sử dụng URL trang đích promo code tùy chỉnh. |
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 thông báo. |
| 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 | | --- | --- | | 36009003 | Lỗi nội bộ. Vui lòng thử lại. Nếu sự cố vẫn tiếp diễn sau nhiều lần thử, vui lòng liên hệ với bộ phận hỗ trợ nền tảng. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext