Создать или обновить категорию
Категории адресуются внешним ID, как в YML-импорте. Если категории нет, создаёт её: тогда нужен name. Если есть, меняет переданные поля. Родителя задайте через parentExternalId. Право: references:write.
bearerApiKeyАвторизацияBearer <rsk_live_…>Ключ 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://refsales.ru/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.