Авторизация в портале
После того как ваше приложение одобрено, авторизуйте каналы в портале разработчика перед вызовом procurement или fulfillment APIs.
Есть два уровня выбора:
- Режим фулфилмента — хранит ли и отправляет ли HioBuy международно
- Режим procurement (только при включённом складском фулфилменте) — кто покупает на Taobao / 1688 / Weidian
Режим фулфилмента (для приложения)
| Режим | Кто держит привязку склада | Международная доставка (/v1/fulfillment/*) |
|---|---|---|
| Self fulfillment (по умолчанию) | Нет — логистику ведёте вы | Недоступна (403) |
| Склад HioBuy | Один складской код разработчика | Доступна — Обзор фулфилмента |
Публичные пути API остаются теми же (/v1/products/*, /v1/orders/*, …). Gateway маршрутизирует по режимам вашего приложения.
Procurement при складском фулфилменте
Когда вы выбираете Склад HioBuy, procurement поддерживает два варианта. Международное хранение и доставка работают в обоих случаях; отличается только кто размещает закупочные заказы на маркетплейсе.
| Режим procurement | Кто покупает на маркетплейсе | Токены каналов | /v1/orders/* | /v1/products/* |
|---|---|---|---|---|
| HioBuy procurement (по умолчанию) | HioBuy покупает за вас | Выдаются при авторизации склада; Gateway хранит их | Через складской procurement HioBuy | Gateway использует сохранённые токены → маркетплейс |
| Self procurement | Вы покупаете со своих аккаунтов | Вы управляете OAuth / credentials в портале | Gateway → маркетплейс с вашими токенами (как классический self-поток) | То же — ваши токены |
| Возможность | HioBuy procurement | Self procurement |
|---|---|---|
| Привязать код склада один раз | Да | Да |
| Приём на склад / посылки / VAS / возвраты | Да | Да |
| Международные отправки и кошелёк | Да | Да |
| OAuth маркетплейса управляете вы | Нет | Да (по каналу) |
Переключение между этими двумя вариантами procurement может очистить или перевыпустить токены каналов; портал запросит подтверждение.
Self fulfillment (без склада HioBuy)
Для каждого включённого канала (Taobao, 1688, Weidian, …):
- Откройте Authorizations → выберите app → Authorize
- Вставьте OAuth credentials или завершите OAuth, когда доступно
- Портал показывает status, account name, expiry — но никогда полные токены
/v1/fulfillment/* в этом режиме недоступен.
Складской фулфилмент HioBuy (настройка)
Тарифы: Складской фулфилмент HioBuy и выделенная поддержка требуют платный тариф (Growth / Enterprise). В бесплатных тарифах доступны документация для самостоятельной работы и Sandbox. Выделенная поддержка по интеграции и фулфилменту доступна на платных тарифах.
- Получите warehouse developer code у HioBuy ops
- Portal → Authorizations → выберите Use HioBuy fulfillment
- Выберите режим procurement: HioBuy procurement или self procurement
- Введите код склада один раз — привязка на уровне приложения (не по каналу)
- Если HioBuy procurement: портал показывает статус каждого канала и
expires_at(токены не видны и не редактируются) - Если self procurement: сами завершите OAuth / ввод credentials по каналам; привязка склада только открывает fulfillment APIs
Переключение обратно на self fulfillment очищает складскую привязку; вам будет предложено подтвердить.
Что вы никогда не отправляете в API calls
- Marketplace access tokens
- Warehouse developer code (Gateway прикрепляет его server-side)
Только Authorization: Bearer hio_live_… (или hio_test_…) на https://api.hiobuy.com.
Далее: Обзор фулфилмента · Заказы
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days