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

Удалить службу доставки

DELETE /v1/delivery-services/:id

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

Параметры

Параметр Тип Обяз. Описание
id (path) integer да Положительный безопасный целочисленный идентификатор из списка служб доставки

Примеры

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

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/delivery-services/85" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/delivery-services/85" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

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

const { success, data } = await res.json()
console.log(success && data === true)

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

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

const { success, data } = await res.json()
console.log(success && data === true)

Поля ответа

HTTP-статус — 200 OK.

Поле Тип Описание
success boolean true при успехе
data boolean true — удаление подтверждено

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

JSON 
{
  "success": true,
  "data": true
}

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

404 — служба с указанным идентификатором не найдена:

JSON 
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "Entity not found"
  }
}

Ошибки

HTTP error.code Описание
400 INVALID_PARAMS id не является положительным безопасным целым числом
404 ENTITY_NOT_FOUND Служба с указанным id не найдена
422 BITRIX_ERROR Битрикс24 отклонил или не подтвердил удаление. Причина указана в error.message
502 BITRIX_RESPONSE_INVALID Ответ на удаление имеет некорректную структуру
403 BITRIX_ACCESS_DENIED Нет права на удаление службы, служба создана без REST-обработчика или принадлежит другому OAuth-приложению
401 TOKEN_MISSING У API-ключа нет настроенных токенов Битрикс24
403 SCOPE_DENIED У API-ключа нет скоупа delivery
403 WRITE_BLOCKED_READONLY_KEY API-ключ работает в режиме только для чтения

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

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