Для AI-агентов: markdown этой страницы — /docs-content/entities/basket-item-properties/delete.md индекс документации — /llms.txt

Удалить свойство позиции корзины

DELETE /v1/basket-item-properties/:id

Удаляет свойство существующей позиции корзины по идентификатору, когда его данные больше не нужны. Восстановить удалённую запись через API нельзя.

Параметры

Параметр Тип Обяз. Описание
id (path) number да ID свойства. Источник: GET /v1/basket-item-properties

Примеры

curl — личный ключ

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/basket-item-properties/1037" \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth-приложение

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/basket-item-properties/1037" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/basket-item-properties/1037', {
  method: 'DELETE',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})

if (res.status === 204) {
  console.log("Свойство позиции корзины удалено")
}

JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/basket-item-properties/1037', {
  method: 'DELETE',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

if (res.status === 204) {
  console.log("Свойство позиции корзины удалено")
}

Ответ

При успешном удалении возвращается HTTP-статус 204 No Content с пустым телом. Признак успеха — код ответа.

Пример ответа

http 
HTTP/1.1 204 No Content

Пример ответа при ошибке

404 — свойство не найдено:

JSON 
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "basket property is not exists"
  }
}

Ошибки

HTTP Код Описание
400 INVALID_PARAMS id в пути не является целым неотрицательным числом
404 ENTITY_NOT_FOUND Свойства с таким id нет или оно уже удалено
422 BITRIX_ERROR Битрикс24 отклонил операцию. Причина — в message
403 WRITE_BLOCKED_READONLY_KEY Ключ работает в режиме только для чтения
403 SCOPE_DENIED API-ключ не имеет скоупа sale
401 MISSING_API_KEY Не передан заголовок X-Api-Key
429 RATE_LIMITED Превышен лимит запросов

Полный список общих ошибок API — Коды ошибок.

Смотрите также