Рефсейлс API
Справочники

Категории товаров

GET
/api/v1/references/categories

Категории товаров магазина. id передавайте в categoryId товара, externalId в categoryExternalId. Список короткий, поэтому приходит одной страницей. Право: references:read.

Авторизация

bearerApiKey
headerАвторизацияBearer <rsk_live_…>

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

Ответ

Категории товаров

application/json
  1. response
data*array<>

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

page*

Пагинация.

Example Request
curl -X GET 'https://refsales.ru/api/v1/references/categories'
Example Response
{  "data": [    {      "id": "5b2e8d1a-7c3f-4e9a-b0d6-1f4a8c2e9b73",      "externalId": "MS-CAT-7",      "name": "Свечи",      "parentId": null,      "createdAt": "2026-05-04T12:00:00.418265+00:00",      "updatedAt": "2026-09-20T08:15:42.418265+00:00"    }  ],  "page": {    "nextCursor": null,    "hasMore": false  }}