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

Создать или обновить категорию

PUT
/api/v1/references/categories/external/{externalId}

Категории адресуются внешним ID, как в YML-импорте. Если категории нет, создаёт её: тогда нужен name. Если есть, меняет переданные поля. Родителя задайте через parentExternalId. Право: references:write.

Авторизация

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

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

Где: header

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

externalId*string

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

Тело запроса

application/json

Типы TypeScript

Готовый тип для вашего кода.

Ответ

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/api/v1/references/categories/external/string" \  -H "Content-Type: application/json" \  -d '{    "name": "Свечи",    "parentExternalId": null  }'
{  "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"  }}

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

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

Удалить категорию DELETE

Удаляет категорию по ID, а с by=externalId по внешнему ID. Товары остаются без категории, дочерние категории становятся корневыми. Право: references:write.