POST Search Creator Target Collaborations
Tìm kiếm chiến dịch hợp tác mục tiêu của Creator Creator Scope bắt buộc: creator.affiliate_collaboration.read API này được dùng để tìm kiếm các chiến dịch hợp tác mục tiêu của creator và các sản phẩm trong những chiến dịch hợp tác mục tiêu đó. Phiên bản 202405
POST/affiliate_creator/202405/target_collaborations/search
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được phép: application/json |
| x-tts-access-token Required | string | Giá trị creator access_token lấy từ Get Access Token, khi user_type = 1. Làm theo hướng dẫn này để lấy creator access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key riêng 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 được người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được dùng trong 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. |
| page_token | string | Một token mờ (opaque) dùng để lấy trang tiếp theo của tập kết quả phân trang. Lấy giá trị này từ kết quả next_page_token của một phản hồi trước đó. Không cần thiết cho trang đầu tiên. |
| page_size Required | int | Số lượng kết quả trả về trên mỗi trang. Phạm vi hợp lệ: [0-100]. |
Body
| Properties | Type | Description |
|---|---|---|
| shop_id Required | string | Mã định danh của TikTok Shop. |
| keyword_type | string | Các chiến dịch hợp tác mục tiêu trong phản hồi bị giới hạn theo kiểu được chỉ định. Đây là một wtype liệt kê với các giá trị:- TARGET_COLLABORATIONS_ID- TARGET_COLLABORATIONS_NAMETARGET_COLLABORATIONS_ID trả về các chiến dịch hợp tác mục tiêu có state là LIVE, EXPIRED, DELETED, và ENDED. TARGET_COLLABORATIONS_NAME chỉ trả về các chiến dịch hợp tác mục tiêu có state là LIVE. |
| keyword | string | Các chiến dịch hợp tác mục tiêu trong phản hồi bị giới hạn theo tên được 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 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 | | --- | --- | | Empty. No business logic error codes. |
Is this content helpful?Helpful
Not Helpful
PreviousNext