Создать или обновить категорию
Категории адресуются внешним ID, как в YML-импорте. Если категории нет, создаёт её: тогда нужен name. Если есть, меняет переданные поля. Родителя задайте через parentExternalId. Право: references:write.
bearerApiKeyАвторизацияBearer <ключ>Ключ API в заголовке Authorization: Bearer rsk_live_…. Ключ создаёт владелец магазина: Настройки → Интеграции → API-ключи.
externalId*stringID категории в вашей системе.
application/json- body
name?stringНазвание. Обязательно, если категории ещё нет.
1 <= length <= 255parentExternalId?|externalId родительской категории. null делает категорию корневой.
Категория обновлена.
application/json- response
data*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.