API Рефсейлс
REST API v1 для заказов, товаров, клиентов и справочников магазина. Авторизация по ключу, суммы в копейках, курсорная пагинация.
API отдаёт данные одного магазина: того, чей ключ стоит в заголовке. Через него внешние системы читают каталог и клиентов, создают и меняют заказы: склад, 1С-коннектор, ваш бэкенд, таблица с отчётами.
curl https://refsales.ru/api/v1/orders?limit=5 \
-H "Authorization: Bearer rsk_live_xxx"Быстрый старт
Ключ, первый запрос и первый заказ.
Авторизация
Ключи, права (scopes), отзыв.
Ошибки
Коды ответов и формат тела ошибки.
Справочник
Все методы с примерами и песочницей.
Что есть в v1
| Раздел | Методы | Права |
|---|---|---|
| Заказы | список, один заказ, создание, изменение | orders:read, orders:write |
| Товары | список, один товар по ID, внешнему ID или артикулу | products:read |
| Клиенты | список, один клиент | customers:read |
| Справочники | статусы заказа и оплаты, способы оплаты и доставки, склады | references:read |
| Диагностика | проверка ключа, версия API | не нужны |
Доступ открыт на тарифе «Оптимальный». Машиночитаемый контракт лежит
в /api/v1/openapi.json.