POST Tìm kiếm Target Collaborations
Tìm kiếm Target Collaborations Shop Scope yêu cầu: seller.affiliate_collaboration.read API này được Seller sử dụng để tìm kiếm tất cả target collaborations hiện có. Seller có thể tìm kiếm dựa trên các bộ lọc như tên Invitation, Invitation ID, tên Product, Product ID và tên Creator. Phiên bản 202508
POST/affiliate_seller/202508/target_collaborations/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 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 request API tới TTS, bạn phải ký chúng để TTS có thể nhận dạng 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 request API. Developer có thể dùng cái này để chuyển đổi sang giờ địa phương. |
| page_size | int | Giá trị của "page_size" phải là 20, 50 hoặc 100. |
| page_token | string | Pagination offset xác định nơi bạn bắt đầu tìm kiếm. Nó rỗng khi bạn gửi request đầu tiên. |
| shop_cipher Required | string | Sử dụng property 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 cross-border sẽ trả về response không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| creator_accept_status | string | Lọc theo trạng thái chấp nhận của creator được mời vào target collaborations.Bạn có thể truy vấn dựa trên:- "ACCEPT", nghĩa là creator đã thêm sản phẩm vào showcase- "ALL""", nghĩa là bất kể creator có thêm sản phẩm vào Showcase hay không.Theo mặc định, target collaborations sẽ được tìm kiếm theo trạng thái "ALL". |
| free_sample_setting | string | Lọc theo cài đặt free sample của target collaborations.Bạn có thể truy vấn dựa trên:- "WITH_FREE_SAMPLE"- "ALL"Theo mặc định, target collaborations sẽ được tìm kiếm theo cài đặt "ALL". |
| search_param | object | Tham số tìm kiếm. |
| creator_user_open_id | string | TikTok User Open ID của creator.Chi tiết thêm- CREATOR_OPEN_ID: Nếu bạn dùng CREATOR_OPEN_ID để tìm kiếm, bạn có thể tìm kiếm thông tin target collaboration cho một creator ID cụ thể. |
| collaboration_status Required | string | Lọc theo trạng thái của target collaborations.Bạn có thể truy vấn dựa trên:- ONGOING: Nếu bạn dùng ONGOING để tìm kiếm, thời hạn hiệu lực còn lại của target collaborations được trả về sẽ lớn hơn 7 ngày.- EXPIRING: Nếu bạn dùng EXPIRING để tìm kiếm, thời hạn hiệu lực còn lại của target collaborations được trả về sẽ nhỏ hơn 7 ngày.- VALID: Nếu bạn dùng VALID để tìm kiếm, tất cả target collaborations được trả về sẽ còn hiệu lực.- CANCELING: Nếu bạn dùng CANCELING để tìm kiếm, tất cả target collaborations được trả về sẽ đang trong quá trình hủy.- COMPLETED: Nếu bạn dùng COMPLETED để tìm kiếm, tất cả target collaborations được trả về sẽ ở trạng thái đã hoàn thành, bao gồm đã hết hạn và đã hủy. |
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 response API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong response API. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Request log |
| 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 | | --- | --- | | Rỗ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