POST Search Package
Tìm kiếm Package Shop Scope yêu cầu: seller.fulfillment.basic Lấy package ID dựa trên các điều kiện được chỉ định. Thời gian tạo package và thời gian cập nhật thông tin là các điều kiện truy vấn phổ biến. Phiên bản 202309
POST/fulfillment/202309/packages/search
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được 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 | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi 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 trong tất cả các API request. Nhà phát triển có thể dùng giá trị này để chuyển đổi sang giờ địa phương. |
| page_size Required | int | Số lượng kết quả được trả về trên mỗi trang. Khoảng hợp lệ: [1-50]. |
| sort_field | string | Kết quả trả về sẽ được sắp xếp theo field được chỉ định. Mặc định: create_timeCác giá trị có thể:- create_time- update_time- order_pay_timeChỉ định thứ tự sắp xếp kết quả trả về bằng cách sử dụng tham số sort_order. |
| sort_order | string | Thứ tự sắp xếp cho tham số sort_field. Mặc định: DESCCác giá trị có thể:- ASC: Thứ tự tăng dần- DESC: Thứ tự giảm dần |
| page_token | string | Một token mờ được sử dụng để lấy 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. |
| shop_cipher | string | Sử dụng property 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 |
Body
| Properties | Type | Description |
|---|---|---|
| create_time_ge | int | Lọc các package để chỉ hiển thị những package được tạo sau (hoặc tại) ngày và giờ được chỉ định. Unix timestamp. |
| create_time_lt | int | Lọc các package để chỉ hiển thị những package được tạo trước ngày và giờ được chỉ định. Unix timestamp. |
| update_time_ge | int | Lọc các package để chỉ hiển thị những package được cập nhật sau (hoặc tại) ngày và giờ được chỉ định. Unix timestamp. |
| update_time_lt | int | Lọc các package để chỉ hiển thị những package được cập nhật trước ngày và giờ được chỉ định. Unix timestamp. |
| package_status | string | Các giá trị có thể:- PROCESSING: Package đã được seller sắp xếp. Đang chờ đơn vị vận chuyển đến lấy kiện hàng.- FULFILLING: Package đã được đơn vị vận chuyển lấy và đang vận chuyển.- COMPLETED: Package đã được giao.- CANCELLED: Package đã bị hủy. Thông thường, package bị hủy do bị mất hoặc hư hỏng. |
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 | Log của request |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 36009003 | Lỗi nội bộ. Vui lòng thử lại. Nếu sự cố vẫn tiếp diễn sau nhiều lần thử, vui lòng liên hệ bộ phận hỗ trợ nền tảng. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext