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 |
| 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 |
| 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 |
|---|---|
source_product_id | lines[].offer_id |
variants[].sku_id | lines[].spec_id |
Xem Order preview để biết luồng create đầy đủ.