Перейти к содержимому
CargoDuo logoCargoDuo
Цены
Документация для разработчиковСправочник APIТранспорт

Удалить транспортное средство

Удаляет одно из ваших транспортных средств.

DELETEhttps://runner.cargoduo.com/v1/vehicles/{id}

Пресеты доступны только для чтения. Бесплатно: кредиты не списываются.

Аутентификация

Bearer-ключ API с правомresources:writeПодробнее

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

ИмяТипОбязательноОписание
idstringобязательно
string
Да

ID пресета или одного из ваших транспортных средств (veh_…).

Пример запроса

curl -X DELETE "https://runner.cargoduo.com/v1/vehicles/veh_118" \
  -H "Authorization: Bearer $CARGODUO_API_KEY"

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

200 OK · Deleted
{
  "id": "veh_118",
  "object": "vehicle",
  "deleted": true
}

Ответы

  • 200OKУдалено.
    ИмяТипОбязательноОписание
    idstring
    string
    Нет
    objectstring
    string
    Нет
    vehicletemplateproject
    deletedboolean
    boolean
    Нет

    Всегда true.

  • 401Unauthorizedunauthorizedkey_revokedkey_expired
    • unauthorizedAPI-ключ отсутствует, имеет неверный формат или неизвестен.
    • key_revokedКлюч отозван.
    • key_expiredСрок действия ключа истёк.
    ИмяТипОбязательноОписание
    errorErrorBodyобязательно
    ErrorBody
    Да
    Все коды ошибок
  • 403Forbiddenpreset_read_onlyip_not_allowedsubscription_inactiveaccount_inactivescope_missing
    • preset_read_onlyПресеты нельзя изменять или удалять.
    • ip_not_allowedIP-адреса вызывающей стороны нет в списке разрешённых IP для этого ключа.
    • subscription_inactiveУ организации нет активной подписки, включающей API.
    • account_inactiveРабота организации приостановлена, или у неё нет владельца с активной учётной записью.
    • scope_missingУ ключа нет области доступа, необходимой для этого endpoint.
    ИмяТипОбязательноОписание
    errorErrorBodyобязательно
    ErrorBody
    Да
    Все коды ошибок
  • 404Not foundvehicle_not_found
    • vehicle_not_foundТранспортного средства с таким ID нет ни среди пресетов, ни среди транспортных средств вашей организации.
    ИмяТипОбязательноОписание
    errorErrorBodyобязательно
    ErrorBody
    Да
    Все коды ошибок
  • 429Too many requestsrate_limited
    • rate_limitedСлишком много запросов за текущую минуту, час или сутки (на ключ или на организацию) либо число неудачных попыток аутентификации с вашего IP-адреса превысило 60 в минуту.
    ИмяТипОбязательноОписание
    errorErrorBodyобязательно
    ErrorBody
    Да
    Все коды ошибок
  • 500Internal server errorinternal_error
    • internal_errorСбой на нашей стороне.
    ИмяТипОбязательноОписание
    errorErrorBodyобязательно
    ErrorBody
    Да
    Все коды ошибок
  • 503Service unavailableapi_disabled
    • api_disabledAPI временно отключён (техническое обслуживание) или выключен для организации.
    ИмяТипОбязательноОписание
    errorErrorBodyобязательно
    ErrorBody
    Да
    Все коды ошибок