POST List Opportunity
List Opportunity Shop Scope bắt buộc: seller.product.basic Tìm kiếm và truy xuất danh sách phân trang các opportunity lead có sẵn cho seller được ủy quyền, với bộ lọc tùy chọn theo type, status, category, v.v. và được sắp xếp theo mô hình xếp hạng của thuật toán. Version 202604
POST/product/202604/opportunities/query
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Type cho phép: application/json |
| x-tts-access-token Required | string | Giá 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
| 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 | Signature đượ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 trên tất cả các API request. Nhà phát triển có thể dùng để chuyển đổi sang giờ địa phương. |
| page_size Required | int | Số lượng kết quả mỗi trang. Tối đa: 100. Mặc định: 20. |
| page_token | string | Pagination token từ response trước đó. Bỏ qua đối với trang đầu tiên. |
| locale | string | Được biểu diễn bằng {language_code}-{COUNTRY_CODE}, theo chuẩn BCP-47. |
| shop_cipher Required | string | Sử dụng property này để truyền thông tin shop khi request API. Việc không truyền đúng giá trị khi request API cho các shop cross-border sẽ trả về response không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| opportunity_type Required | string | Type của opportunity: PRODUCT（品线索）/ KEYWORD（词线索）/ CATEGORY（类目线索） |
| category_ids | []string | Lọc theo category ID. Để trống để trả về tất cả lead có sẵn cho seller. |
| create_time_ge | int | Lọc các opportunity được tạo sau thời điểm này. timestamp tính bằng giây |
| create_time_lt | int | Lọc các opportunity được tạo trước thời điểm này. timestamp tính bằng giây |
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 API response. |
| message | string | Thô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_id | string | Request log |
| data | object | Thô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