PUT Cập nhật Target Collaboration
Cập nhật Target Collaboration Shop Scope yêu cầu: seller.affiliate_collaboration.write API này được Seller sử dụng để cập nhật target collaboration loại STANDARD. Phiên bản 202508
PUT/affiliate_seller/202508/target_collaborations/{target_collaboration_id}
Request
Path
| Properties | Type | Description |
|---|---|---|
| target_collaboration_id Required | string | ID duy nhất của target collaboration cụ thể. |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được 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 đế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 sử dụng trên tất cả các request 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 | Sử dụng thuộc tính này để truyền thông tin shop khi gọi API. Việc không truyền giá trị chính xác 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 |
|---|---|---|
| name Required | string | Tên của target collaboration. |
| end_time Required | string | Thời gian kết thúc của target collaboration. |
| products Required | []object | Thông tin về các sản phẩm mà seller cung cấp cho target collaboration với các creator trong target collaboration. Số lượng sản phẩm tối đa là 100. Khi một sản phẩm bị xóa khỏi danh sách sản phẩm, nếu sản phẩm bị xóa đã được creator thêm vào showcase thì sẽ có hiệu lực vào 0:00 ngày hôm sau, ngược lại sẽ có hiệu lực ngay lập tức. |
| creator_user_open_ids Required | []string | Danh sách TikTok User Open ID của các Creator được mời trong target collaboration. Số lượng creator tối đa là 50. Chi tiết thêm |
| seller_contact_info Required | object | Thông tin liên hệ của seller trong target collaboration. |
| free_sample_rule Required | object | Các quy tắc về mẫu miễn phí do seller thiết lập trong target collaboration. |
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 | Log request |
| 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 | | --- | --- | | 16024004 | test account and non test account can not cross invite | | 16024006 | The seller cannot invite their official creator. | | 16024008 | There are products that do not belong to this merchant. | | 16024016 | The invitation failed because the creator is already linked with a shop account. | | 16024018 | seller can not invite his block creator | | 16024019 | in sufficient quota to create invitation | | 16024020 | remove excluded creators to create invitation | | 16024021 | invitation contains creator exceed follower limit | | 36009007 | request timeout | | 50001701 | target collaboration has expired | | 50001702 | Your invitation target contains an unavailable creator or product. Please check your request params.Remove the unavailable creator or product id and try again. | | 50001703 | The request parameters contain sensitive words. | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 98001004 | Parameter {param_name} is invalid. Reason: {reason}. Expected: {expected_value} |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext