Tổng quan Products API
API sản phẩm hợp nhất cho 1688, Taobao và Weidian. Truyền channel khi search/detail, hoặc dùng URL parse để tự động nhận diện.
Giá là CNY yuan — không có tham số currency, không chuyển đổi ngoại tệ. Đặt language trong JSON body (Languages). Dùng response_format: "standard" (mặc định) hoặc "upstream" (Response format).
Hướng dẫn endpoint
| Chủ đề | Endpoint | Tài liệu |
|---|---|---|
| Chi tiết sản phẩm & ma trận SKU | POST /v1/products/detail | Product detail |
| Tìm kiếm từ khóa | POST /v1/products/search | Product search |
| Similar (Taobao) | POST /v1/products/similar | Advanced endpoints |
| Upload ảnh để tái sử dụng | POST /v1/products/upload-image | Upload image |
| Tìm bằng ảnh | POST /v1/products/search-by-image | Image search |
| Parse URL sản phẩm | POST /v1/products/parse | Parse URL |
| Schema phản hồi | — | Product response models |
| ID danh mục 1688 | — | Danh mục 1688 |
| Kênh, freight, analytics | various | Advanced endpoints |
Khả năng theo kênh
Truy vấn flag trực tiếp: GET /v1/products/channels. Tóm tắt:
| Khả năng | 1688 | Taobao | Weidian |
|---|---|---|---|
| Detail | ✓ | ✓ | ✓ |
| Keyword search | ✓ | ✓ | — |
| Image search | ✓ | ✓ | — |
| URL parse | ✓ | ✓ | ✓ |
Taobao口令 (tao_password) | — | ✓ | — |
| Ước tính freight nội địa | ✓ | ✓ | — |
| Mua tự động (orders) | ✓ | ✓ | Tùy trường hợp |
Mapping mua hộ {#procurement-mapping}
Sau khi chọn variant trên product detail, map id sang order lines:
| Field chi tiết | Field đơn hàng |
|---|---|
id (1688 offerId; Taobao mi_id) | lines[].id (compatible: offer_id, Taobao mi_id) |
source_product_id | 1688 same as id; Taobao = item_id |
variants[].sku_id | lines[].spec_id |
Xem Order preview để biết luồng create đầy đủ.
id/mi_idTaobao thay đổi định kỳ. Đừng cache lâu. Id cũ sẽ làm detail, similar và đơn hàng thất bại. Lấy lại trước khi checkout.
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days