POST Tạo Open Collaboration
Tạo Open Collaboration Shop Scope bắt buộc: seller.affiliate_collaboration.write API này cho phép người bán tạo một open collaboration. Bạn tạo một open collaboration bằng cách chọn sản phẩm và thiết lập tỷ lệ hoa hồng. Phiên bản 202412
POST/affiliate_seller/202412/open_collaborations
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được 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 riêng biệ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 API request đế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 cho tất cả các API request. 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 |
|---|---|---|
| product_id Required | string | ID sản phẩm để thêm vào affiliate open collaboration. |
| commission_rate Required | int | Tỷ lệ hoa hồng mong muốn cho open collaboration. Tỷ lệ hoa hồng mong muốn được biểu thị theo phần trăm với đơn vị phần trăm. Ví dụ, 3587 là tỷ lệ hoa hồng 35.87%. Giá trị này phải tối thiểu là 100. |
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 của API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong response của API. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Nhật ký request |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
Xem các mã lỗi phổ biến
| Code | Message | | --- | --- | | 16003012 | Đã tồn tại một open collaboration chứa sản phẩm này. | | 16003025 | Tài khoản của người bán đã bị vô hiệu hóa. | | 16003033 | Tỷ lệ hoa hồng phải nằm trong khoảng từ 1% đến 80%. | | 16003035 | Một hoặc nhiều sản phẩm bạn đang cố gắng thêm hiện đang bị nền tảng hạn chế. | | 16603010 | Người bán hiện đang bị nền tảng hạn chế. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext