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

Получить транспортное средство

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

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

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

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

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

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

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

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

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

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

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

200 OK · SavedVehicle
{
  "id": "veh_118",
  "object": "vehicle",
  "kind": "custom",
  "name": "Mega trailer 13.6 m",
  "type": "trailer",
  "length": 1360,
  "width": 248,
  "height": 300,
  "max_weight": 24000,
  "floor_load_capacity": null,
  "axle_positions": [],
  "axle_max_loads": [],
  "cog_range_x": null,
  "cog_range_y": null,
  "aux_deck": false,
  "aux_deck_height": null,
  "aux_deck_max_weight": null,
  "tractor_weight": null,
  "empty_trailer_weight": null,
  "front_axle_to_middle_axle": null,
  "front_axle_to_tractor_cog": null,
  "front_axle_to_kingpin": null,
  "kingpin_to_rear_axle": null,
  "trailer_cog_to_rear_axle": null,
  "trailer_start_to_kingpin": null,
  "max_middle_axle_weight": null,
  "max_rear_axle_weight": null,
  "blocked_areas": [],
  "created_by": {
    "id": "usr_7",
    "name": "Elif Kaya"
  },
  "updated_by": {
    "id": "usr_7",
    "name": "Elif Kaya"
  },
  "created_at": "2026-10-02T08:41:17Z"
}

Ответы

  • 200OKТранспортное средство.
    ИмяТипОбязательноОписание
    idstring
    string
    Нет

    ID пресета или veh_… для ваших транспортных средств.

    objectstring
    string
    Нет
    vehicle
    kindstring
    string
    Нет

    preset = встроенный каталог; custom = транспортные средства вашей организации.

    presetcustom
    typestring
    string
    Нет

    Тип транспортного средства. Принимаются только типы из GET /v1/limits (allowed_vehicle_types).

    trucktrailerflatbedcontainerpalletaircraftship
    namestring
    string
    Нет

    Отображаемое название.

    lengthnumber · cm
    number · cm
    Нет

    Внутренняя длина грузового пространства, по x (от передней стенки к дверям).

    widthnumber · cm
    number · cm
    Нет

    Внутренняя ширина грузового пространства, по z.

    heightnumber · cm
    number · cm
    Нет

    Внутренняя высота грузового пространства, по y.

    max_weightnumber · kg
    number · kg
    Нет

    Максимальная грузоподъёмность.

    floor_load_capacitynumber | null · kg/m²
    number | null · kg/m²
    Нет

    Допустимая нагрузка на пол: 0 или больше (0 = без ограничений).

    axle_positionsnumber[] · cm
    number[] · cm
    Нет

    Положения осей (точек опоры) от передней границы грузового пространства; отрицательное значение = перед ней. Та же длина массива, что у axle_max_loads. Каждое значение — от −300 (ось перед грузовым пространством, например передняя ось одиночного грузовика под кабиной) до длины транспортного средства.

    axle_max_loadsnumber[] · kg
    number[] · kg
    Нет

    Максимальная нагрузка груза на каждую ось, в порядке axle_positions. Каждое значение больше 0 и не больше 100000.

    cog_range_xnumber | null · cm
    number | null · cm
    Нет

    Допустимое смещение центра тяжести от середины длины: от 0 до length / 2.

    cog_range_ynumber | null · cm
    number | null · cm
    Нет

    Допустимое смещение центра тяжести от середины ширины: от 0 до width / 2.

    aux_deckboolean
    boolean
    Нет

    У транспортного средства есть второй ярус (двухъярусная загрузка).

    aux_deck_heightnumber | null · cm
    number | null · cm
    Нет

    Высота второго яруса над полом. Обязательна, если aux_deck равно true.

    aux_deck_max_weightnumber | null · kg
    number | null · kg
    Нет

    Допустимая нагрузка на второй ярус. Обязательна, если aux_deck равно true.

    tractor_weightnumber | null · kg
    number | null · kg
    Нет

    Модель осей полуприцепа: масса тягача.

    empty_trailer_weightnumber | null · kg
    number | null · kg
    Нет

    Модель осей полуприцепа: масса порожнего прицепа.

    front_axle_to_middle_axlenumber | null · cm
    number | null · cm
    Нет

    Модель осей полуприцепа: от передней оси тягача до ведущей (средней) оси.

    front_axle_to_tractor_cognumber | null · cm
    number | null · cm
    Нет

    Модель осей полуприцепа: от передней оси до центра тяжести тягача.

    front_axle_to_kingpinnumber | null · cm
    number | null · cm
    Нет

    Модель осей полуприцепа: от передней оси до шкворня (седельно-сцепного устройства).

    kingpin_to_rear_axlenumber | null · cm
    number | null · cm
    Нет

    Модель осей полуприцепа: от шкворня до группы задних осей прицепа.

    trailer_cog_to_rear_axlenumber | null · cm
    number | null · cm
    Нет

    Модель осей полуприцепа: от центра тяжести прицепа до группы задних осей.

    trailer_start_to_kingpinnumber | null · cm
    number | null · cm
    Нет

    Модель осей полуприцепа: от передней части прицепа до шкворня.

    max_middle_axle_weightnumber | null · kg
    number | null · kg
    Нет

    Модель осей полуприцепа: допустимая по закону нагрузка на ведущую (среднюю) ось.

    max_rear_axle_weightnumber | null · kg
    number | null · kg
    Нет

    Модель осей полуприцепа: допустимая по закону нагрузка на группу задних осей.

    blocked_areasRect[]
    Rect[]
    Нет

    Зоны пола, где ничего нельзя ставить (колёсные арки, повреждения, зарезервированное место). Каждая должна лежать в пределах пола транспортного средства.

    created_byUserRef | null
    UserRef | null
    Нет

    Участник, создавший проект (для вызовов API — участник, создавший ключ). null, если неизвестно.

    updated_byUserRef | null
    UserRef | null
    Нет

    Участник, последним изменивший проект.

    created_atstring | null
    string | null
    Нет

    RFC 3339; null для пресетов.

  • 401Unauthorizedunauthorizedkey_revokedkey_expired
    • unauthorizedAPI-ключ отсутствует, имеет неверный формат или неизвестен.
    • key_revokedКлюч отозван.
    • key_expiredСрок действия ключа истёк.
    ИмяТипОбязательноОписание
    errorErrorBodyобязательно
    ErrorBody
    Да
    Все коды ошибок
  • 403Forbiddenip_not_allowedsubscription_inactiveaccount_inactivescope_missing
    • 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
    Да
    Все коды ошибок