Рефсейлс API

Авторизация

Ключ API, права и изоляция магазина.

Каждый запрос несёт ключ в заголовке:

Authorization: Bearer rsk_live_xxx

Магазин определяется по ключу. Передать shopId в запросе нельзя, поэтому чужие данные недоступны даже при ошибке в коде интеграции.

Права

ПравоЧто открывает
orders:readчтение заказов
orders:writeсоздание и изменение заказов
products:readчтение товаров и вариантов
products:writeсоздание, изменение и удаление товаров
customers:readчтение клиентов
customers:writeсоздание, изменение и удаление клиентов
references:readсправочники
references:writeстатусы, склады, способы оплаты и доставки, категории товаров

Способы оплаты и доставки общие для всех магазинов владельца. Название, изменённое ключом одного магазина, увидят и остальные. isActive работает как переключатель в настройках: способ, доступный во всех магазинах владельца, включается и выключается во всех, а способ выбранных магазинов только в магазине ключа.

Без нужного права API вернёт 403 с details.requiredScope.

Хранение и отзыв

В базе хранится только хеш ключа, поэтому показать секрет повторно нельзя. Если ключ потерялся, отзовите его в настройках и выпустите новый. Отозванный или истёкший ключ получает 401.

На странице