Обзор Products API
Унифицированный product API для 1688, Taobao и Weidian. Передавайте channel при search/detail или используйте парсинг URL для автоопределения.
Цены указаны в CNY yuan — без параметра currency, без FX conversion. Задавайте language в JSON body (языки). Используйте response_format: "standard" (по умолчанию) или "upstream" (формат ответа).
Справочник endpoint
| Тема | Endpoint | Документация |
|---|---|---|
| Детали товара и SKU matrix | POST /v1/products/detail | Детали товара |
| Поиск по ключевым словам | POST /v1/products/search | Поиск товаров |
| Загрузка изображения для повторного использования | POST /v1/products/upload-image | Загрузка изображения |
| Поиск по изображению | POST /v1/products/search-by-image | Поиск по изображению |
| Парсинг URL товара | POST /v1/products/parse | Парсинг URL |
| Схемы ответов | — | Модели ответов товаров |
| Каналы, фрахт, аналитика | various | Расширенные endpoint |
Возможности каналов
Запрашивайте актуальные flags: GET /v1/products/channels. Кратко:
| Возможность | 1688 | Taobao | Weidian |
|---|---|---|---|
| Детали | ✓ | ✓ | ✓ |
| Поиск по ключевым словам | ✓ | ✓ | — |
| Поиск по изображению | ✓ | ✓ | — |
| Парсинг URL | ✓ | ✓ | ✓ |
Taobao口令 (tao_password) | — | ✓ | — |
| Оценка внутренней доставки | ✓ | ✓ | — |
| Автозакупка (orders) | ✓ | ✓ | Зависит |
Маппинг закупки {#procurement-mapping}
После выбора variant на деталях товара сопоставьте id с order lines:
| Поле detail | Поле order |
|---|---|
source_product_id | lines[].offer_id |
variants[].sku_id | lines[].spec_id |
См. order preview для полного create flow.