POST Search Open Collaboration
Tìm kiếm open collaboration Shop Scope bắt buộc: seller.affiliate_collaboration.read Truy xuất toàn bộ thông tin open collaboration từ người bán, bao gồm tỷ lệ hoa hồng, thêm vào showcase và số lượng nhà sáng tạo nội dung đã đăng bài. Version 202412
POST/affiliate_seller/202412/open_collaborations/search
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu 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 để chuyển đổi sang giờ địa phương. |
| page_token | string | Offset phân trang xác định vị trí bạn bắt đầu tìm kiếm. Nó để trống khi bạn gửi yêu cầu đầu tiên. |
| page_size Required | int | Giá trị của "page_size" phải lớn hơn 0 và nhỏ hơn hoặc bằng 100. |
| sort_order | string | Giá trị mặc định của "sort_order" là DESC.Enum:- ASC：nghĩa là sắp xếp dữ liệu theo thứ tự tăng dần- DESC：nghĩa là sắp xếp dữ liệu theo thứ tự giảm dần |
| sort_field | string | Một số trường sắp xếp như sau:- product_original_price: sắp xếp theo giá gốc của sản phẩm.Theo mặc định, các open collaboration được sắp xếp theo thứ tự giảm dần theo thời gian tạo. |
| shop_cipher Required | string | Sử dụng property này để truyền thông tin shop khi gọi API. Việc truyền sai 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 |
|---|---|---|
| keyword_type | string | Truyền vào kiểu tham số mà bạn dùng để truy vấn open collaboration. Bạn có thể truy vấn dựa trên:- PRODUCT_ID：Nếu bạn dùng PRODUCT_ID để tìm kiếm, bạn có thể tìm kiếm thông tin open collaboration cho một product ID cụ thể.- PRODUCT_NAME: Nếu bạn dùng PRODUCT_NAME để tìm kiếm, bạn có thể tìm kiếm mờ thông tin open collaboration liên quan đến các tên sản phẩm liên quan. |
| keyword | string | Tìm kiếm dựa trên tên sản phẩm hoặc product ID. Truyền vào giá trị phù hợp dựa trên keyword_type ở trên. |
| top_level_category_id | string | Danh mục của sản phẩm được tìm kiếm cần được giới hạn trong param này.Điều kiện tiên quyết:- Giá trị của trường category_id phải lớn hơn 0.- Hiện tại chỉ hỗ trợ danh mục cấp một |
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ý yêu cầu |
| 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 | | --- | --- | | Trố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