İçeriğe atla
Geliştirici dokümanlarıAPI referansıAraçlar

Aracı getir

Bir hazır araç ya da araçlarınızdan biri.

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

Ücretsiz: kredi harcanmaz.

Kimlik doğrulama

Bearer API anahtarı, gereken yetki:resources:readDaha fazla bilgi

Yol parametreleri

AdTürZorunluAçıklama
idstringzorunlu
string
Evet

Bir hazır araç ID'si ya da araçlarınızdan birinin ID'si (veh_…).

Örnek istek

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

Örnek yanıt

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

Yanıtlar

  • 200OKAraç.
    AdTürZorunluAçıklama
    idstring
    string
    Hayır

    Hazır araç ID'si; kendi araçlarınız için veh_….

    objectstring
    string
    Hayır
    vehicle
    kindstring
    string
    Hayır

    preset = öntanımlı katalog; custom = organizasyonunuzun araçları.

    presetcustom
    typestring
    string
    Hayır

    Araç türü. Yalnızca GET /v1/limits yanıtında listelenen türler (allowed_vehicle_types) kabul edilir.

    trucktrailerflatbedcontainerpalletaircraftship
    namestring
    string
    Hayır

    Görüntülenen ad.

    lengthnumber · cm
    number · cm
    Hayır

    Yük alanının iç uzunluğu, x ekseni boyunca (ön duvardan kapıya doğru).

    widthnumber · cm
    number · cm
    Hayır

    Yük alanının iç genişliği, z ekseni boyunca.

    heightnumber · cm
    number · cm
    Hayır

    Yük alanının iç yüksekliği, y ekseni boyunca.

    max_weightnumber · kg
    number · kg
    Hayır

    Azami taşıma kapasitesi.

    floor_load_capacitynumber | null · kg/m²
    number | null · kg/m²
    Hayır

    Zemin taşıma kapasitesi: 0 ya da daha fazla (0 = sınır yok).

    axle_positionsnumber[] · cm
    number[] · cm
    Hayır

    Yük alanının önünden ölçülen aks (destek noktası) konumları; negatif = yük alanının önünde. axle_max_loads ile aynı uzunlukta olmalıdır. Her biri −300 (yük alanının önündeki bir aks, ör. solo kamyonun kabin altındaki ön aksı) ile araç uzunluğu arasında olmalıdır.

    axle_max_loadsnumber[] · kg
    number[] · kg
    Hayır

    axle_positions sırasıyla aks başına en fazla yük. Her biri 0'dan büyük ve en fazla 100000 olmalıdır.

    cog_range_xnumber | null · cm
    number | null · cm
    Hayır

    Ağırlık merkezinin uzunluğun ortasından izin verilen sapması: 0 ile uzunluk / 2 arası.

    cog_range_ynumber | null · cm
    number | null · cm
    Hayır

    Ağırlık merkezinin genişliğin ortasından izin verilen sapması: 0 ile genişlik / 2 arası.

    aux_deckboolean
    boolean
    Hayır

    Aracın ikinci bir katı var (çift katlı).

    aux_deck_heightnumber | null · cm
    number | null · cm
    Hayır

    İkinci katın zeminden yüksekliği. aux_deck değeri true ise zorunludur.

    aux_deck_max_weightnumber | null · kg
    number | null · kg
    Hayır

    İkinci katın yük sınırı. aux_deck değeri true ise zorunludur.

    tractor_weightnumber | null · kg
    number | null · kg
    Hayır

    Çekici-dorse aks modeli: çekici kütlesi.

    empty_trailer_weightnumber | null · kg
    number | null · kg
    Hayır

    Çekici-dorse aks modeli: boş dorse kütlesi.

    front_axle_to_middle_axlenumber | null · cm
    number | null · cm
    Hayır

    Çekici-dorse aks modeli: çekicinin ön aksından tahrik (orta) aksına mesafe.

    front_axle_to_tractor_cognumber | null · cm
    number | null · cm
    Hayır

    Çekici-dorse aks modeli: ön akstan çekicinin ağırlık merkezine mesafe.

    front_axle_to_kingpinnumber | null · cm
    number | null · cm
    Hayır

    Çekici-dorse aks modeli: ön akstan kingpin'e (beşinci teker) mesafe.

    kingpin_to_rear_axlenumber | null · cm
    number | null · cm
    Hayır

    Çekici-dorse aks modeli: kingpin'den dorsenin arka aks grubuna mesafe.

    trailer_cog_to_rear_axlenumber | null · cm
    number | null · cm
    Hayır

    Çekici-dorse aks modeli: dorsenin ağırlık merkezinden arka aks grubuna mesafe.

    trailer_start_to_kingpinnumber | null · cm
    number | null · cm
    Hayır

    Çekici-dorse aks modeli: dorsenin ön ucundan kingpin'e mesafe.

    max_middle_axle_weightnumber | null · kg
    number | null · kg
    Hayır

    Çekici-dorse aks modeli: tahrik (orta) aksı için yasal sınır.

    max_rear_axle_weightnumber | null · kg
    number | null · kg
    Hayır

    Çekici-dorse aks modeli: arka aks grubu için yasal sınır.

    blocked_areasRect[]
    Rect[]
    Hayır

    Üzerine hiçbir şey konamayacak zemin bölgeleri (tekerlek davlumbazları, hasarlı yerler, ayrılmış alanlar). Her biri araç zemininin içinde olmalıdır.

    created_byUserRef | null
    UserRef | null
    Hayır

    Projeyi oluşturan üye (API çağrılarında: anahtarı oluşturan üye). Bilinmiyorsa null.

    updated_byUserRef | null
    UserRef | null
    Hayır

    Projeyi en son değiştiren üye.

    created_atstring | null
    string | null
    Hayır

    RFC 3339; hazır araçlarda null.

  • 401Unauthorizedunauthorizedkey_revokedkey_expired
    • unauthorizedAPI anahtarı eksik, hatalı biçimde ya da tanınmıyor.
    • key_revokedAnahtar iptal edildi.
    • key_expiredAnahtarın geçerlilik süresi doldu.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları
  • 403Forbiddenip_not_allowedsubscription_inactiveaccount_inactivescope_missing
    • ip_not_allowedİsteği gönderen IP, anahtarın izin listesinde değil.
    • subscription_inactiveOrganizasyonun API'yi içeren etkin bir aboneliği yok.
    • account_inactiveOrganizasyon askıya alınmış ya da hesabı etkin olan bir organizasyon sahibi yok.
    • scope_missingAnahtarda bu endpoint'in gerektirdiği bir yetki eksik.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları
  • 404Not foundvehicle_not_found
    • vehicle_not_foundHazır araçlar ve organizasyonunuzun araçları arasında bu ID'ye sahip bir araç yok.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları
  • 429Too many requestsrate_limited
    • rate_limitedGeçerli dakika, saat ya da gün içinde çok fazla istek gönderildi (anahtar ya da organizasyon başına) veya IP adresinizden gelen başarısız kimlik doğrulama denemeleri dakikada 60 sınırını aştı.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları
  • 500Internal server errorinternal_error
    • internal_errorBizim tarafımızda bir hata oluştu.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları
  • 503Service unavailableapi_disabled
    • api_disabledAPI geçici olarak devre dışı (bakım) ya da organizasyon için kapatılmış.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları