POST Inventory Search
Tìm kiếm tồn kho Shop Scope yêu cầu: seller.product.basic Truy xuất thông tin tồn kho cho nhiều sản phẩm hoặc SKU. Lưu ý:
- Việc tìm kiếm có thể dựa trên product ID hoặc SKU ID, không thể đồng thời cả hai.
- Truyền Product ID sẽ trả về thông tin tồn kho của tất cả SKU thuộc các sản phẩm được chỉ định.
- Truyền SKU ID sẽ trả về thông tin tồn kho cho các SKU được chỉ định. Phiên bản 202309
POST/product/202309/inventory/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 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 sử dụng trên tất cả các yêu cầu API. Lập trình viên có thể dùng giá trị này để chuyển đổi sang giờ địa phương. |
| 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 |
Body
| Properties | Type | Description |
|---|---|---|
| product_ids | []string | Danh sách product ID dùng để tìm kiếm thông tin tồn kho.Số ID tối đa: 100 |
| sku_ids | []string | Danh sách SKU ID dùng để tìm kiếm thông tin tồn kho.Số ID tối đa: 600Lưu ý: Nếu cả sku_ids và product_ids đều được truyền, sku_ids sẽ được ưu tiên. |
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 | Nhật ký 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 phổ biến
| Code | Message | | --- | --- | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 12019008 | Product id is invalid | | 12019015 | The number of SKU exceed the limit | | 12019022 | SKU must contain a valid warehouse. | | 12019112 | seller id is invalid | | 12019114 | Seller has no permission | | 12019120 | The number of provided product IDs exceeds the limit. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext