GET Lấy danh sách Creator bán chạy nhất
Lấy danh sách Creator bán chạy nhất Shop Scope bắt buộc: data.bestselling.public.read Lấy top 100 creator có hiệu suất cao nhất trong khoảng thời gian mục tiêu Phiên bản 202511
GET/analytics/202511/creators/bestselling
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ị seller access_token từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy seller access_token. |
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 nó để chuyển đổi sang giờ địa phương. |
| date Required | string | Ngày tham chiếu (định dạng ISO 8601 YYYY-MM-DD) theo múi giờ đã đăng ký của shop. Truy vấn sẽ tính toán dữ liệu lùi về trước từ ngày được chỉ định này dựa trên tham số time_slot (ví dụ: nếu time_slot là 7D, nó trả về dữ liệu cho 7 ngày kết thúc vào ngày này). Ngày này được tính bao gồm. Phạm vi truy vấn tối đa phụ thuộc vào tham số time_slot. |
| time_slot Required | string | Chỉ định phạm vi thời gian truy vấn. Các giá trị được hỗ trợ là:- 1D — truy vấn dữ liệu cho 1 ngày- 7D — truy vấn dữ liệu cho 7 ngày- 30D — truy vấn dữ liệu cho 30 ngàyTrường này xác định phạm vi tối đa có thể truy vấn bằng trường date. |
| author_type Required | string | Loại người dùng của creator. Đây là kiểu liệt kê với các giá trị:OFFICIAL, CHANNEL, AFFILIATENếu không được cung cấp, mặc định sẽ là tất cả. |
| currency | string | USD hoặc LOCAL |
| shop_cipher Required | string | Sử 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ề phản hồi không chính xác. Lấy bằng API Get Authorization Shop |
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 phản hồi API. |
| message | string | Thô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 thông báo. |
| 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 thường gặp
| 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