Откройте «Настройки → API» и добавьте новое приложение.
Управляйте магазином
из любого приложения
Подключайте CRM, учётные системы, мобильные приложения и собственные сервисы. RuMarket API открывает безопасный доступ к заказам, товарам, остаткам и клиентам.
https://your-store.ru/api/v1
Быстрый старт
Три шага — и интеграция готова к первому запросу.
Скопируйте токен и сохраните секретный ключ в защищённом хранилище.
Выполните тестовый запрос и получите статус магазина.
curl --request GET \
--url 'https://your-store.ru/api/v1/ping' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Accept: application/json'
const response = await fetch('https://your-store.ru/api/v1/ping', {
headers: { Authorization: 'Bearer YOUR_TOKEN' }
});
const data = await response.json();
$client = new GuzzleHttp\Client();
$response = $client->get('https://your-store.ru/api/v1/ping', [
'headers' => ['Authorization' => 'Bearer YOUR_TOKEN']
]);
Авторизация
Каждый запрос подписывается токеном приложения.
Передавайте токен в заголовке Authorization. Секретный ключ никогда не должен попадать в браузер, мобильное приложение или публичный репозиторий.
Если токен стал доступен третьим лицам, отзовите его в панели RuMarket и выпустите новый.
AuthorizationBearer YOUR_TOKENДаContent-Typeapplication/jsonДля POST/PATCHX-RuMarket-SignatureHMAC-SHA256 тела запросаДля webhooksОсновные операции API
Адреса, параметры и готовые примеры ответов.
Получить список заказов
/ordersВозвращает заказы с фильтрацией по номеру, идентификатору, email покупателя, статусу и периоду создания.
Query-параметры
pageintegerНомер страницы, по умолчанию 1
limitintegerОт 1 до 100 записей
numberstringНомер заказа, например RM-10482
emailstringEmail покупателя
statusstringСтатус заказа
curl 'https://your-store.ru/api/v1/orders?status=paid&limit=20' \
-H 'Authorization: Bearer YOUR_TOKEN'{
"data": [{
"id": 10482,
"number": "RM-10482",
"status": "paid",
"total": 12490,
"currency": "RUB"
}],
"meta": { "page": 1, "total": 86 }
}Создать заказ
/ordersСоздаёт заказ с покупателем, товарами, доставкой и способом оплаты. Возвращает полный объект заказа.
{ "customer": {…}, "items": […], "delivery": {…} }АвторизацияИзменить заказ
/orders/{id}Обновляет только переданные поля: статус, комментарий менеджера, доставку или оплату.
{ "status": "paid", "manager_comment": "Оплата подтверждена" }200 · ОбновленоУдалить заказ
/orders/{id}Перемещает заказ в корзину. Операцию можно отменить в панели в течение 30 дней.
Для окончательного удаления требуется отдельное право приложения.
Товары
/productsТовары, варианты, цены, изображения, характеристики и SEO-поля с фильтрацией по SKU и категории.
Категории
/categoriesВозвращает дерево каталога с вложенностью, URL, SEO-метаданными и порядком сортировки.
Обновить остатки
/stocks/batchПакетно синхронизирует остатки по SKU и складам — до 1 000 позиций за запрос.
{ "items": [{ "sku": "RM-001", "warehouse_id": 2, "quantity": 18 }] }До 1000 позицийКлиенты
/customersПрофили покупателей, группы, накопительные скидки и статистика заказов с учётом прав приложения.
Запрашивайте только необходимые поля и соблюдайте требования к их защите.
Webhooks
Получайте события сразу после изменений.
order.createdСоздан новый заказorder.status_changedИзменился статусproduct.updatedОбновлён товарstock.changedИзменился остатокRuMarket подписывает webhook алгоритмом HMAC-SHA256. Сравнивайте подпись с заголовком X-RuMarket-Signature.
Ошибки и статусы
Единый формат упрощает обработку ответа.
Создайте приложение
и отправьте первый запрос
Тестовая среда не влияет на данные рабочего магазина.