Przejdź do treści
Dokumentacja dla deweloperówDokumentacja APIPojazdy

Zaktualizuj pojazd

Zmienia jeden z Twoich pojazdów.

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

Presety są tylko do odczytu. Bezpłatnie: nie pobieramy kredytów.

Uwierzytelnianie

Klucz API (Bearer) z zakresemresources:writeWięcej informacji

Parametry ścieżki

NazwaTypWymaganyOpis
idstringwymagane
string
Tak

ID presetu lub jednego z Twoich pojazdów (veh_…).

Parametry treści

application/json
NazwaTypWymaganyOpis
typestring
string
Nie

Typ pojazdu. Akceptowane są tylko typy wymienione w GET /v1/limits (allowed_vehicle_types).

trucktrailerflatbedcontainerpalletaircraftship
namestring
string
Nie

Wyświetlana nazwa.

≤ 255 chars
lengthnumber · cm
number · cm
Nie

Wewnętrzna długość przestrzeni ładunkowej, wzdłuż osi x (od przedniej ściany w stronę drzwi).

widthnumber · cm
number · cm
Nie

Wewnętrzna szerokość przestrzeni ładunkowej, wzdłuż osi z.

heightnumber · cm
number · cm
Nie

Wewnętrzna wysokość przestrzeni ładunkowej, wzdłuż osi y.

max_weightnumber · kg
number · kg
Nie

Maksymalna ładowność.

floor_load_capacitynumber · kg/m²
number · kg/m²
Nie

Nośność podłogi: 0 lub więcej (0 = bez limitu).

aux_deckboolean
boolean
Nie

Pojazd ma drugi pokład (dwupoziomowy).

Domyślnie false
aux_deck_heightnumber · cm
number · cm
Nie

Wysokość drugiego pokładu nad podłogą. Wymagana, gdy aux_deck ma wartość true.

aux_deck_max_weightnumber · kg
number · kg
Nie

Limit obciążenia drugiego pokładu. Wymagany, gdy aux_deck ma wartość true.

blocked_areasRect[]
Rect[]
Nie

Obszary podłogi, na których nic nie może stać (nadkola, uszkodzenia, zarezerwowane miejsce). Każdy musi leżeć na podłodze pojazdu.

≤ 32 items
axle_positionsWymaga dostępunumber[] · cm
number[] · cm
Nie

Położenia osi (punktów podparcia) liczone od przodu przestrzeni ładunkowej; ujemne = przed nią. Tyle samo elementów co axle_max_loads. Każda wartość od −300 (oś przed przestrzenią ładunkową, np. przednia oś pod kabiną w ciężarówce solo) do długości pojazdu.

≤ 10 items
axle_max_loadsWymaga dostępunumber[] · kg
number[] · kg
Nie

Maksymalny nacisk ładunku na każdą oś, w kolejności z axle_positions. Każda wartość większa od 0 i nie większa niż 100000.

≤ 10 items
cog_range_xWymaga dostępunumber · cm
number · cm
Nie

Dopuszczalne odchylenie środka ciężkości od środka długości: od 0 do length / 2.

cog_range_yWymaga dostępunumber · cm
number · cm
Nie

Dopuszczalne odchylenie środka ciężkości od środka szerokości: od 0 do width / 2.

tractor_weightWymaga dostępunumber · kg
number · kg
Nie

Model osi naczepy: masa ciągnika.

empty_trailer_weightWymaga dostępunumber · kg
number · kg
Nie

Model osi naczepy: masa pustej naczepy.

front_axle_to_middle_axleWymaga dostępunumber · cm
number · cm
Nie

Model osi naczepy: od osi przedniej ciągnika do osi napędowej (środkowej).

front_axle_to_tractor_cogWymaga dostępunumber · cm
number · cm
Nie

Model osi naczepy: od osi przedniej do środka ciężkości ciągnika.

front_axle_to_kingpinWymaga dostępunumber · cm
number · cm
Nie

Model osi naczepy: od osi przedniej do sworznia królewskiego (siodła).

kingpin_to_rear_axleWymaga dostępunumber · cm
number · cm
Nie

Model osi naczepy: od sworznia królewskiego do grupy osi tylnych naczepy.

trailer_cog_to_rear_axleWymaga dostępunumber · cm
number · cm
Nie

Model osi naczepy: od środka ciężkości naczepy do grupy osi tylnych.

trailer_start_to_kingpinWymaga dostępunumber · cm
number · cm
Nie

Model osi naczepy: od przodu naczepy do sworznia królewskiego.

max_middle_axle_weightWymaga dostępunumber · kg
number · kg
Nie

Model osi naczepy: dopuszczalny nacisk na oś napędową (środkową).

max_rear_axle_weightWymaga dostępunumber · kg
number · kg
Nie

Model osi naczepy: dopuszczalny nacisk na grupę osi tylnych.

Przykładowe zapytanie

curl -X PATCH "https://runner.cargoduo.com/v1/vehicles/veh_118" \
  -H "Authorization: Bearer $CARGODUO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "max_weight": 25000
  }'

Przykładowa odpowiedź

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": 25000,
  "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"
}

Odpowiedzi

  • 200OKPojazd po zmianie.
    NazwaTypWymaganyOpis
    idstring
    string
    Nie

    ID presetu lub veh_… dla własnych pojazdów.

    objectstring
    string
    Nie
    vehicle
    kindstring
    string
    Nie

    preset = katalog predefiniowanych pojazdów; custom = pojazdy Twojej organizacji.

    presetcustom
    typestring
    string
    Nie

    Typ pojazdu. Akceptowane są tylko typy wymienione w GET /v1/limits (allowed_vehicle_types).

    trucktrailerflatbedcontainerpalletaircraftship
    namestring
    string
    Nie

    Wyświetlana nazwa.

    lengthnumber · cm
    number · cm
    Nie

    Wewnętrzna długość przestrzeni ładunkowej, wzdłuż osi x (od przedniej ściany w stronę drzwi).

    widthnumber · cm
    number · cm
    Nie

    Wewnętrzna szerokość przestrzeni ładunkowej, wzdłuż osi z.

    heightnumber · cm
    number · cm
    Nie

    Wewnętrzna wysokość przestrzeni ładunkowej, wzdłuż osi y.

    max_weightnumber · kg
    number · kg
    Nie

    Maksymalna ładowność.

    floor_load_capacitynumber | null · kg/m²
    number | null · kg/m²
    Nie

    Nośność podłogi: 0 lub więcej (0 = bez limitu).

    axle_positionsnumber[] · cm
    number[] · cm
    Nie

    Położenia osi (punktów podparcia) liczone od przodu przestrzeni ładunkowej; ujemne = przed nią. Tyle samo elementów co axle_max_loads. Każda wartość od −300 (oś przed przestrzenią ładunkową, np. przednia oś pod kabiną w ciężarówce solo) do długości pojazdu.

    axle_max_loadsnumber[] · kg
    number[] · kg
    Nie

    Maksymalny nacisk ładunku na każdą oś, w kolejności z axle_positions. Każda wartość większa od 0 i nie większa niż 100000.

    cog_range_xnumber | null · cm
    number | null · cm
    Nie

    Dopuszczalne odchylenie środka ciężkości od środka długości: od 0 do length / 2.

    cog_range_ynumber | null · cm
    number | null · cm
    Nie

    Dopuszczalne odchylenie środka ciężkości od środka szerokości: od 0 do width / 2.

    aux_deckboolean
    boolean
    Nie

    Pojazd ma drugi pokład (dwupoziomowy).

    aux_deck_heightnumber | null · cm
    number | null · cm
    Nie

    Wysokość drugiego pokładu nad podłogą. Wymagana, gdy aux_deck ma wartość true.

    aux_deck_max_weightnumber | null · kg
    number | null · kg
    Nie

    Limit obciążenia drugiego pokładu. Wymagany, gdy aux_deck ma wartość true.

    tractor_weightnumber | null · kg
    number | null · kg
    Nie

    Model osi naczepy: masa ciągnika.

    empty_trailer_weightnumber | null · kg
    number | null · kg
    Nie

    Model osi naczepy: masa pustej naczepy.

    front_axle_to_middle_axlenumber | null · cm
    number | null · cm
    Nie

    Model osi naczepy: od osi przedniej ciągnika do osi napędowej (środkowej).

    front_axle_to_tractor_cognumber | null · cm
    number | null · cm
    Nie

    Model osi naczepy: od osi przedniej do środka ciężkości ciągnika.

    front_axle_to_kingpinnumber | null · cm
    number | null · cm
    Nie

    Model osi naczepy: od osi przedniej do sworznia królewskiego (siodła).

    kingpin_to_rear_axlenumber | null · cm
    number | null · cm
    Nie

    Model osi naczepy: od sworznia królewskiego do grupy osi tylnych naczepy.

    trailer_cog_to_rear_axlenumber | null · cm
    number | null · cm
    Nie

    Model osi naczepy: od środka ciężkości naczepy do grupy osi tylnych.

    trailer_start_to_kingpinnumber | null · cm
    number | null · cm
    Nie

    Model osi naczepy: od przodu naczepy do sworznia królewskiego.

    max_middle_axle_weightnumber | null · kg
    number | null · kg
    Nie

    Model osi naczepy: dopuszczalny nacisk na oś napędową (środkową).

    max_rear_axle_weightnumber | null · kg
    number | null · kg
    Nie

    Model osi naczepy: dopuszczalny nacisk na grupę osi tylnych.

    blocked_areasRect[]
    Rect[]
    Nie

    Obszary podłogi, na których nic nie może stać (nadkola, uszkodzenia, zarezerwowane miejsce). Każdy musi leżeć na podłodze pojazdu.

    created_byUserRef | null
    UserRef | null
    Nie

    Członek organizacji, który go utworzył (przy wywołaniach API: twórca klucza). null, gdy nieznany.

    updated_byUserRef | null
    UserRef | null
    Nie

    Członek organizacji, który ostatnio go zmienił.

    created_atstring | null
    string | null
    Nie

    RFC 3339; null dla presetów.

  • 400Bad requestinvalid_json
    • invalid_jsonTreść nie jest prawidłowym JSON-em lub pole ma niewłaściwy typ.
    NazwaTypWymaganyOpis
    errorErrorBodywymagane
    ErrorBody
    Tak
    Wszystkie kody błędów
  • 401Unauthorizedunauthorizedkey_revokedkey_expired
    • unauthorizedBrak klucza API, nieprawidłowy format klucza lub nieznany klucz.
    • key_revokedKlucz został unieważniony.
    • key_expiredKlucz utracił ważność.
    NazwaTypWymaganyOpis
    errorErrorBodywymagane
    ErrorBody
    Tak
    Wszystkie kody błędów
  • 403Forbiddenpreset_read_onlyip_not_allowedsubscription_inactiveaccount_inactivescope_missing
    • preset_read_onlyPresetów nie można zmieniać ani usuwać.
    • ip_not_allowedAdresu IP, z którego przyszło wywołanie, nie ma na liście dozwolonych adresów klucza.
    • subscription_inactiveOrganizacja nie ma aktywnej subskrypcji obejmującej API.
    • account_inactiveOrganizacja jest zawieszona albo nie ma właściciela z aktywnym kontem.
    • scope_missingKlucz nie ma zakresu wymaganego przez ten endpoint.
    NazwaTypWymaganyOpis
    errorErrorBodywymagane
    ErrorBody
    Tak
    Wszystkie kody błędów
  • 404Not foundvehicle_not_found
    • vehicle_not_foundNie ma pojazdu o tym ID wśród presetów ani pojazdów Twojej organizacji.
    NazwaTypWymaganyOpis
    errorErrorBodywymagane
    ErrorBody
    Tak
    Wszystkie kody błędów
  • 422Unprocessable entityvalidation_failed
    • validation_failedZapytanie to poprawny składniowo JSON, ale opisuje nieprawidłowe zadanie. details[] zawiera wszystkie problemy.
    NazwaTypWymaganyOpis
    errorErrorBodywymagane
    ErrorBody
    Tak
    Wszystkie kody błędów
  • 429Too many requestsrate_limited
    • rate_limitedZa dużo zapytań w bieżącej minucie, godzinie lub dobie (na klucz lub na organizację) albo przekroczony limit nieudanych uwierzytelnień z Twojego adresu IP (60 na minutę).
    NazwaTypWymaganyOpis
    errorErrorBodywymagane
    ErrorBody
    Tak
    Wszystkie kody błędów
  • 500Internal server errorinternal_error
    • internal_errorWystąpił błąd po naszej stronie.
    NazwaTypWymaganyOpis
    errorErrorBodywymagane
    ErrorBody
    Tak
    Wszystkie kody błędów
  • 503Service unavailableapi_disabled
    • api_disabledAPI jest tymczasowo wyłączone (prace konserwacyjne) lub wyłączone dla organizacji.
    NazwaTypWymaganyOpis
    errorErrorBodywymagane
    ErrorBody
    Tak
    Wszystkie kody błędów