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

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

DELETE
/api/v1/references/categories/{id}

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

Авторизация

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

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

Где: header

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

id*string

ID категории или, с by=externalId, внешний ID.

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

by?string

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

Value in

  • "id"
  • "externalId"

Ответ

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/api/v1/references/categories/string"
{  "data": {    "id": "5b2e8d1a-7c3f-4e9a-b0d6-1f4a8c2e9b73",    "deleted": true  }}

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

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

Проверить ключ GET

Показывает, какому магазину принадлежит ключ, какие у него права и до когда он действует. Секрет не возвращается. Подходит для проверки подключения: нужен только рабочий ключ, без отдельного права.