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

GET Get Opportunity Detail

Get Opportunity Detail Shop Scope bắt buộc: seller.product.basic Truy xuất toàn bộ chi tiết của một opportunity lead theo ID của nó, bao gồm dữ liệu xu hướng thị trường, mức độ cạnh tranh và các hành động được đề xuất. Phiên bản 202604

GET/product/202604/opportunities/{opportunity_id}

Request

Path

PropertiesTypeDescription
opportunity_id RequiredstringID duy nhất của opportunity lead được tạo bởi TikTok Shop.

Header

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

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 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 RequiredintUnix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các API request. Lập trình viên có thể dùng để chuyển đổi sang giờ địa phương.
localestringĐược biểu diễn bằng {language_code}-{COUNTRY_CODE}, theo chuẩn BCP-47.
shop_cipher RequiredstringSử dụng thuộc tính 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

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 API response.
messagestringThông báo thành công hoặc thất bại được trả về trong API response. Lý do thất bại sẽ được mô tả trong message.
request_idstringLog của request
dataobjectThông tin trả về cụ thể

Example

JSONEnable word wrap

Error Code

View common error codes

| Code | Message | | --- | --- | | Empty. No business logic error codes. |

Is this content helpful?Helpful

Not Helpful

PreviousNext