Рефсейлс API
Товары

Список товаров

GET
/api/v1/products

Товары и варианты магазина. Вариант отличается от обычного товара заполненным parentId. Цены в копейках. Право: products:read.

Авторизация

bearerApiKey
headerАвторизацияBearer <ключ>

Ключ API в заголовке Authorization: Bearer rsk_live_…. Ключ создаёт владелец магазина: Настройки → Интеграции → API-ключи.

Параметры запроса

filter[externalId]?string

ID товара во внешней системе.

filter[sku]?string

Артикул.

filter[parentId]?string

Только варианты этого товара.

Formatuuid
filter[updatedAt][from]?string

Изменены не раньше, ISO 8601 включительно.

Formatdate-time
filter[updatedAt][to]?string

Изменены не позже, ISO 8601 включительно.

Formatdate-time
order?string

Сортировка. По умолчанию createdAt:desc. Для синхронизации берите updatedAt:asc.

Value in"createdAt:desc""createdAt:asc""updatedAt:desc""updatedAt:asc"
cursor?string

Курсор из page.nextCursor предыдущего ответа. Работает только с той же сортировкой.

limit?integer

Размер страницы от 1 до 100. По умолчанию 50.

Ответ

Страница товаров.

application/json
  1. response
data*array<>

Записи текущей страницы.

page*

Пагинация.

curl -X GET "https://example.com/api/v1/products"
{  "data": [    {      "id": "dcd53ddb-8104-4e48-8cc0-5df1c5a0d1e2",      "externalId": "MS-00124",      "sku": "CNDL-200-PINE",      "name": "Свеча ароматическая «Хвоя», 200 г",      "description": "Соевый воск, хлопковый фитиль, горит 40 часов.",      "price": 120000,      "stockQuantity": 34,      "categoryId": "5b2e8d1a-7c3f-4e9a-b0d6-1f4a8c2e9b73",      "categoryName": "Свечи",      "parentId": null,      "variantAttributes": null,      "url": "https://candles.ru/tproduct/124-hvoya",      "imageUrl": "https://static.tildacdn.com/tild3139/hvoya.jpg",      "weightGrams": 350,      "widthCm": 9,      "heightCm": 11,      "depthCm": 9,      "createdAt": "2026-05-04T12:00:00.418265+00:00",      "updatedAt": "2026-09-20T08:15:42.418265+00:00"    },    {      "id": "7f3a9c2e-1b5d-4e8a-9c0f-3e6b2d8a1c54",      "externalId": "MS-00124-L",      "sku": "CNDL-400-PINE",      "name": "Свеча ароматическая «Хвоя», 400 г",      "description": "Соевый воск, хлопковый фитиль, горит 40 часов.",      "price": 190000,      "stockQuantity": 12,      "categoryId": "5b2e8d1a-7c3f-4e9a-b0d6-1f4a8c2e9b73",      "categoryName": "Свечи",      "parentId": "dcd53ddb-8104-4e48-8cc0-5df1c5a0d1e2",      "variantAttributes": {        "Объём": "400 г"      },      "url": "https://candles.ru/tproduct/124-hvoya",      "imageUrl": "https://static.tildacdn.com/tild3139/hvoya.jpg",      "weightGrams": 620,      "widthCm": 9,      "heightCm": 11,      "depthCm": 9,      "createdAt": "2026-05-04T12:00:00.418265+00:00",      "updatedAt": "2026-09-20T08:15:42.418265+00:00"    }  ],  "page": {    "nextCursor": "WyIyMDI2LTA1LTA0VDEyOjAwOjAwLjQxODI2NSswMDowMCIsIjdmM2E5YzJlLTFiNWQtNGU4YS05YzBmLTNlNmIyZDhhMWM1NCJd",    "hasMore": true  }}

Изменить заказ PATCH

Меняет статус, статус оплаты, контакты покупателя, адрес доставки или комментарий. Передайте хотя бы одно поле. Статус задаётся системным кодом (status) или ID (statusId); статус, который магазин создал сам, выставляется только по ID. Так же для оплаты: paymentStatus или paymentStatusId. Суммы и externalId не меняются. Право: orders:write.

Получить товар GET

Один товар. Ищет по ID Рефсейлс, а с by=externalId или by=sku по внешнему ID или артикулу. Если совпадений несколько, вернётся самый старый товар. Право: products:read.