Открытая платформа HIOBuy

HIOBuy является официальным авторизованным технологическим партнером Taobao, 1688 и Weidian. Мы соединяем китайские источники поставок с вашей платформой через единый API — не только данные о товарах, но и весь путь от синхронизации каталога до автоматизированной закупки и, при необходимости, международной доставки.

Что предоставляет HIOBuy

В отличие от универсальных скрейперов маркетплейсов или read-only фидов данных, HIOBuy построен вокруг сквозного фулфилмента. Ваша интеграция должна обслуживать реальные транзакции на вашей витрине и через наши API закупок.

Диаграмма (HIOBuy соединяет китайские источники с вашей платформой: синхронизация товаров, прием заказов, автозакупка и синхронизация статусов)

HIOBuy находится между китайскими маркетплейсами и вашим бизнесом — синхронизирует товары, принимает заказы, автоматически закупает и отправляет статусы обратно в вашу панель.

Возможность	Что это значит для вас
Синхронизация товаров	Поиск, детали, поиск по изображению, SKU/остатки/цены из 1688, Taobao, Weidian через `/v1/products/*`
Прием заказов	Ваш backend отправляет клиентские заказы в HIOBuy, когда на вашем сайте происходит продажа
Автозакупка	HIOBuy размещает соответствующий заказ на исходном маркетплейсе через `/v1/orders/*`
Синхронизация статусов	Ход закупки, внутренняя логистика и (в складском режиме) международный трекинг возвращаются в ваши системы — см. вебхуки
Международный фулфилмент	Опционально: входящие складские посылки отправляются за рубеж через `/v1/fulfillment/*` (только складской режим)

Чем мы отличаемся от других API

Официальный доступ к каналам — авторизованные партнерские интеграции, а не неофициальный скрейпинг.
Ориентация на транзакции — API товаров существуют для поддержки сорсинга и оформления заказа; API закупок замыкают цикл покупки.
Единые стандартные ответы — одна схема для 1688, Taobao и Weidian; см. формат ответа.
Опциональный full-stack фулфилмент — self mode для покупателей, которые управляют логистикой самостоятельно; warehouse mode, когда HIOBuy должен хранить товары и отправлять их международно.

Допустимое использование и квоты {#acceptable-use}

Доступ к API не является безлимитным. Квоты и лимиты запросов привязаны к вашему коммерческому соглашению и ожидаемому объему транзакций (GMV) через платформу.

HIOBuy предназначен для интеграций, где поиск товаров приводит к реальным заказам — клиенты покупают на вашем сайте, а ваш backend вызывает /v1/orders/* для закупки. Приложения, которые только потребляют поиск/детали товаров без значимой активности покупок или обходят HIOBuy для закупок, используя при этом наши API каталога, не поддерживаются и могут быть приостановлены после проверки.

Технические заголовки rate-limit и коды ошибок описаны в разделе лимиты запросов. Коммерческие условия согласуются во время onboarding — они не повторяются на страницах отдельных endpoint.

Потоки интеграции {#integration-flows}

Выберите режим фулфилмента в портале разработчика, когда авторизуете приложение. Путь Product API похож; закупка и международная доставка отличаются.

Self fulfillment — вы управляете закупкой

Подходит, если у вас уже есть аккаунты на маркетплейсах и вы самостоятельно управляете складированием.

Синхронизация товаров — 1688 / Taobao / Weidian → HIOBuy Gateway: поиск, детали, изображения, SKU, остатки
Отображение — HIOBuy Gateway → ваша витрина
Клиентский заказ — ваш клиент → ваш сайт
Закупка — ваш backend → HIOBuy Gateway: POST /v1/orders/preview → create → pay
Автозакупка — HIOBuy Gateway → маркетплейс (ваш OAuth)
Возврат статуса — маркетплейс → HIOBuy Gateway: закупка и внутренняя логистика
Синхронизация панели — HIOBuy Gateway → ваша панель

Международная доставка (/v1/fulfillment/*) недоступна в self mode. Вы самостоятельно обрабатываете зарубежную доставку.

Складской фулфилмент HIOBuy — от начала до конца

Один складской код связывает все каналы; HIOBuy закупает, хранит и отправляет международно.

Product APIs — по-прежнему вызывают маркетплейсы напрямую (низкая задержка)
Синхронизация товаров — на ваш клиентский сайт
Клиентский заказ — на вашем сайте
Закупка — POST /v1/orders/* (пересылается на склад HIOBuy)
Автозакупка — склад HIOBuy → маркетплейс с управляемыми токенами
Входящие посылки — товары прибывают; parcel_nos в деталях заказа
Международная отправка — freight/estimate → preview → create → pay
Доставка — отслеживание через /v1/fulfillment/shipments/logistics/trace

API закупок и международные API маршрутизируются через HIOBuy. Product APIs остаются прямыми к платформам для скорости.

Сравнение режимов

	Self fulfillment	Склад HIOBuy
Токены каналов	Вы управляете OAuth для каждого канала	Один складской код связывает все каналы
`/v1/products/*`	Gateway → маркетплейс	Gateway → маркетплейс (напрямую, низкая задержка)
`/v1/orders/*`	Gateway → маркетплейс (ваши токены)	Gateway → API склада HIOBuy
`/v1/fulfillment/*`	Недоступно	Международная доставка + баланс

Как стать разработчиком {#become-a-developer}

Зарегистрируйтесь, указав компанию, сайт и сценарий использования (например, агент по закупкам, трансграничный магазин).
Подтвердите адрес электронной почты.
Войдите и создайте App в портале разработчика — опишите вашу интеграцию и ожидаемый трафик.
Дождитесь проверки HIOBuy. Мы одобряем приложения, соответствующие транзакционному сорсингу; после этого вы получите квоту и доступ к каналам.
После одобрения: авторизуйте каналы (self OAuth или складской код), затем создайте API-ключ в API Keys.
Интегрируйте: детали товара → checkout клиента → preview/create закупки → pay → вебхуки статусов. В складском режиме добавьте поток международной отправки.

Нужен складской код разработчика? Свяжитесь с операционной командой HIOBuy после одобрения приложения для складского фулфилмента.

Карта справочника API

Base URL: https://api.hiobuy.com/v1

Область	Префикс	Документация
Товары	`/v1/products/*`	Товары
Закупка	`/v1/orders/*`	Заказы закупки
Фулфилмент	`/v1/fulfillment/*`	Отправления и баланс

Два типа заказов — не смешивайте: закупка (/v1/orders/*) покупает у китайских продавцов на внутренний склад; международное отправление (/v1/fulfillment/shipments/*) отправляет входящие посылки за рубеж.

Область Public API {#public-api-scope}

Эта документация описывает поддерживаемую поверхность Public API. Некоторые пути могут присутствовать в openapi.json для внутреннего или устаревшего использования (например, legacy /v1/shipments, refund routes) — если endpoint здесь не указан, считайте его недоступным.

Технические соглашения {#technical-conventions}

Auth: Authorization: Bearer YOUR_API_KEY — аутентификация
Product language в JSON body — языки
Цены: CNY yuan для товаров, fen для заказов и отправлений
response_format: "standard" (по умолчанию) или "upstream" — формат ответа

OpenAPI spec: api.hiobuy.com/openapi.json

Опубликованная документация: hiobuy.com/api-docs