Языки

Язык текста товаров задается через language в API JSON body, а не через locale URL портала (/en vs /zh).

Цены всегда в CNY

API не принимает currency и не выполняет FX conversion. Стандартные ответы используют original_currency и display_currency со значением CNY и той же суммой в yuan. При необходимости конвертируйте на своей стороне.

Поле запроса

Поле	Обязательно	По умолчанию	Описание
`language`	Нет	`en`	Locale перевода для названий, атрибутов и результатов поиска.

Пример

POST /v1/products/search

{
  "channel": "1688",
  "keyword": "phone case",
  "language": "ja",
  "page": 1,
  "page_size": 10
}

Маппинги каналов

Полные таблицы locale находятся в data/language-mappings.json. Кратко:

Маппинг 1688

Актуальные официальные языковые enum 1688 (country). Упрощённый китайский (zh / zh-CN / cn) больше не поддерживается — Gateway откатывается на en.

Вы отправляете	Код 1688	Примечание
`en`	`en`	Английский
`ja`	`ja`	Японский
`ko`	`ko`	Корейский
`ru`	`ru`	Русский
`vi`	`vi`	Вьетнамский
`fr`	`fr`	Французский
`pt`	`pt`	Португальский
`zh-tw` / `zh_TW`	`zh-tw`	Традиционный китайский
`es`	`es`	Испанский
`id`	`id`	Индонезийский
`th`	`th`	Тайский

Маппинг Taobao

Вы отправляете	Код IOP	Примечание
`en`	`en`	Английский
`vi`	`vi`	Вьетнамский
`ru`	`ru`	Русский
`ko`	`ko`	Корейский
`ja`	`ja`	Японский
`zh` / `zh-CN` / `cn`	`cn`	Китайский

См. поиск товаров и детали товара для примеров с language.

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support