POST Tạo Target Collaboration
Tạo Target Collaboration Shop Scope bắt buộc: seller.affiliate_collaboration.write API này được dùng để tạo một target collaboration. Một target collaboration là sự hợp tác giữa một tập sản phẩm do người bán chọn (bao gồm khoản chi trả hoa hồng) và một tập các nhà sáng tạo mà người bán đã thêm (mời) vào collaboration. Target collaboration là riêng tư và không hiển thị trong Creator Marketplace với tất cả nhà sáng tạo; chúng chỉ hiển thị với những người đã được thêm vào collaboration. Version 202508
POST/affiliate_seller/202508/target_collaborations
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 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 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ể 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 | 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 xuyên biên giới 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. |
| message | string | Tin nhắn gửi đến các nhà sáng tạo liên kết với target collaboration. |
| end_time Required | string | Ngày target collaboration kết thúc, ở định dạng Unix epoch time. |
| products Required | []object | Danh sách metadata và dữ liệu của các sản phẩm do người bán cung cấp cho target collaboration. Độ dài tối đa của danh sách là 100 sản phẩm. |
| creator_user_open_ids Required | []string | Độ dài tối đa của danh sách là 50 user open identifier. Creator Open ID. Chi tiết |
| seller_contact_info Required | object | Metadata và dữ liệu liên quan đến thông tin liên hệ của người bán. |
| free_sample_rule Required | object | Một tập các property kiểm soát hành vi mẫu miễn phí cho sản phẩm. |
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 | | --- | --- | | 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. | | 16024019 | in sufficient quota to create invitation | | 16024020 | remove excluded creators to create invitation | | 16024021 | invitation contains creator exceed follower limit | | 16024022 | This invitation has exist creator and product, please check conflict pair. | | 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