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, изменение, удаление | products:read, products:write |
| Клиенты | список, один клиент, поиск или создание, изменение, удаление | customers:read, customers:write |
| Справочники | статусы заказа и оплаты, способы оплаты и доставки, склады, категории товаров: чтение и запись | references:read, references:write |
| Диагностика | проверка ключа, версия API | не нужны |
Доступ открыт на тарифе «Оптимальный». Машиночитаемый контракт лежит
в /api/v1/openapi.json.