Chuyển tới nội dung chính

POST Top Showcase Products

Top Showcase Products Creator Scope yêu cầu: creator.showcase.write Sử dụng API này để đưa sản phẩm lên đầu trong showcase của creator. Nền tảng sẽ trả về mã lỗi và thông báo lỗi nếu thao tác ghim thất bại. Version 202409

POST/affiliate_creator/202409/showcases/products/top

Request

Header

PropertiesTypeDescription
content-type RequiredstringKiểu được phép: application/json
x-tts-access-token RequiredstringGiá trị access_token của creator từ Get Access Token, khi user_type = 1. Làm theo hướng dẫn này để lấy access_token của creator.

Query

PropertiesTypeDescription
app_key RequiredstringMỗ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 RequiredstringChữ 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 RequiredintUnix timestamp GMT (UTC+00:00). Timestamp này được sử dụng cho tất cả các yêu cầu API. Nhà phát triển có thể dùng cái này để chuyển đổi sang giờ địa phương.

Body

PropertiesTypeDescription
product_ids Required[]stringCác product ID cần đưa lên đầu trong showcase của creator. Nếu nhiều sản phẩm được cung cấp, chúng sẽ hiển thị theo thứ tự được truyền trong tham số này.

Example

CurlGoNode.jsJavaEnable word wrap

Response Parameters

PropertiesTypeDescription
codeintMã trạng thái thành công hoặc thất bại được trả về trong phản hồi API.
messagestringThông báo thành công hoặc thất bại được trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong message.
request_idstringLog yêu cầu
dataobjectThông tin trả về cụ thể

Example

JSONEnable word wrap

Error Code

View common error codes

| Code | Message | | --- | --- | | 16015001 | Invalid parameter, the product Ids are not correct. Please ensure the products are in the showcase right now. | | 16015027 | System error |

Is this content helpful?Helpful

Not Helpful

PreviousNext