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

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

GET
/api/v1/products/{id}

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

Авторизация

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

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

Где: header

Параметры пути

id*string

ID товара, внешний ID или артикул, в зависимости от by.

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

by?string

По какому полю искать. По умолчанию id.

Value in

  • "id"
  • "externalId"
  • "sku"

Ответ

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/products/string"
{  "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.000Z",    "updatedAt": "2026-09-20T08:15:42.000Z"  }}