Merchant API

Merchant API — это REST API для администраторов магазинов. Через него внешняя учётная система (CRM, ERP, складская программа) синхронизирует данные с магазином: загружает цены и остатки, читает и обновляет заказы и их статусы.

Полный контракт со схемами всех полей — в OpenAPI-спецификации. Эта документация объясняет, как им пользоваться.

Базовый адрес

Все методы находятся под префиксом /api/merchant-service/.... Базовый адрес сервиса:

https://admin.mobiusapp.ru

Полный URL метода выглядит так:

https://admin.mobiusapp.ru/api/merchant-service/orders/list

Авторизация

Доступ — по bearer-токену. Токен выдаётся по email и паролю учётной записи магазина, затем передаётся в заголовке каждого защищённого запроса:

Authorization: Bearer <token>

Подробнее — в разделе Авторизация.

Контекст магазина

Магазин определяется автоматически по bearer-токену — передавать его идентификатор в запросах не нужно. Все данные (заказы, цены, остатки) читаются и пишутся в контексте магазина, привязанного к учётной записи. Если к учётной записи не привязан ни один активный магазин, метод вернёт бизнес-ошибку (422).

Синхронные и асинхронные методы

Разделы

• Авторизация — получение и использование bearer-токена, лимиты на вход.
• Ошибки, лимиты и пагинация — форматы ошибок, HTTP-статусы, ограничение частоты запросов, постраничная выдача.
• Импорт цен и остатков — батч-загрузка цен и остатков по складам.
• Заказы — список с фильтрами, карточка, обновление, смена статуса, отмена.

С чего начать

1. Получите bearer-токен — см. Авторизация.
2. Загрузите цены и остатки — см. Импорт цен и остатков.
3. Читайте и обновляйте заказы — см. Заказы.
4. Чтобы реагировать на события магазина (создан заказ, оплачен, отменён) в реальном времени, подключите вебхуки.

Связанные разделы

• Вебхуки — события магазина на ваш URL.
• OpenAPI документация — схемы всех полей.