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

Pobierz pojazd

Preset lub jeden z Twoich pojazdów.

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

Bezpłatnie: nie pobieramy kredytów.

Uwierzytelnianie

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

Parametry ścieżki

NazwaTypWymaganyOpis
idstringwymagane
string
Tak

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

Przykładowe zapytanie

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

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

Odpowiedzi

  • 200OKPojazd.
    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.

  • 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
  • 403Forbiddenip_not_allowedsubscription_inactiveaccount_inactivescope_missing
    • 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
  • 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