POST Tìm kiếm Sản phẩm Hợp tác Mở của Affiliate cho Người bán

Tìm kiếm Sản phẩm Hợp tác Mở của Affiliate cho Người bán Shop Scope bắt buộc: seller.affiliate_collaboration.read API này được dùng để tìm kiếm thông tin của các sản phẩm có hợp tác mở theo danh mục, tỷ lệ hoa hồng và từ khóa. Nó sẽ trả về tất cả sản phẩm trên TikTok Shop Affiliate Product Marketplace đang ở trạng thái hợp tác mở. Người bán chỉ có thể tìm kiếm hợp tác mở trong các khu vực mà họ đã đăng ký bán hàng. Phiên bản 202405

POST/affiliate_seller/202405/open_collaborations/products/search

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 tới 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.
sort_order	string	Thứ tự sắp xếp cho tham số sort_field. Mặc định: ASCCác giá trị có thể có:- ASC: Thứ tự tăng dần- DESC: Thứ tự giảm dần
sort_field	string	Kết quả trả về sẽ được sắp xếp theo trường được chỉ định. Xem mô tả các giá trị trường trong request body để biết thêm thông tin về mỗi trường.Mặc định: commission_rateCác giá trị có thể có:- commission_rate- product_sales_price- commission- units_sold
page_token	string	Một token mờ (opaque token) được dùng để truy xuất trang tiếp theo của tập kết quả phân trang. Lấy giá trị này từ kết quả next_page_token của response trước đó. Không cần thiết cho trang đầu tiên.
page_size Required	int	Số lượng kết quả được trả về trên mỗi trang. Phạm vi hợp lệ: [1-20].
shop_cipher Required	string	Sử dụng thuộc tính này để truyền thông tin shop khi yêu cầu API. Việc không truyền đúng giá trị khi yêu cầu 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
title_keywords	[]string	Một danh sách các từ khóa sản phẩm. Tiêu đề, hoặc tên sản phẩm, được khớp một cách lỏng lẻo. Các từ khóa trong danh sách tạo thành một truy vấn và tập hợp tên sản phẩm khớp kết quả dựa trên toán tử liên kết AND giữa mỗi từ khóa. Ví dụ, danh sách từ khóa ["Men", "Fashion"] tạo ra một truy vấn "Men" AND "Fashion" và tập hợp tên sản phẩm khớp kết quả chứa sự liên kết được khớp lỏng lẻo của "Men" và "Fashion" như "Male Fashionable". Độ dài tối đa của danh sách là 20 từ khóa. Độ dài chuỗi từ khóa tối đa là 255 ký tự.
sales_price_range	object	Giới hạn các sản phẩm trong kết quả tìm kiếm chỉ còn những sản phẩm có giá lớn hơn hoặc bằng giá tối thiểu được biểu thị và nhỏ hơn giá tối đa được biểu thị
category	object	Giới hạn các sản phẩm trong kết quả tìm kiếm chỉ còn những sản phẩm được liên kết với danh mục sản phẩm được biểu thị.
commission_rate_range	object	Giới hạn các sản phẩm trong kết quả tìm kiếm chỉ còn những sản phẩm có tỷ lệ hoa hồng lớn hơn tỷ lệ hoa hồng tối thiểu được biểu thị và nhỏ hơn tỷ lệ hoa hồng tối đa được biểu thị.

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 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