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

Aracı güncelle

Araçlarınızdan birini değiştirir.

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

Hazır araçlar salt okunurdur. Ücretsiz: kredi harcanmaz.

Kimlik doğrulama

Bearer API anahtarı, gereken yetki:resources:writeDaha 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_…).

Gövde parametreleri

application/json
AdTürZorunluAçıklama
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.

≤ 255 chars
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 · kg/m²
number · kg/m²
Hayır

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

aux_deckboolean
boolean
Hayır

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

Varsayılan false
aux_deck_heightnumber · cm
number · cm
Hayır

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

aux_deck_max_weightnumber · kg
number · kg
Hayır

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

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.

≤ 32 items
axle_positionsErişim gerekirnumber[] · 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.

≤ 10 items
axle_max_loadsErişim gerekirnumber[] · 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.

≤ 10 items
cog_range_xErişim gerekirnumber · cm
number · cm
Hayır

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

cog_range_yErişim gerekirnumber · cm
number · cm
Hayır

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

tractor_weightErişim gerekirnumber · kg
number · kg
Hayır

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

empty_trailer_weightErişim gerekirnumber · kg
number · kg
Hayır

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

front_axle_to_middle_axleErişim gerekirnumber · cm
number · cm
Hayır

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

front_axle_to_tractor_cogErişim gerekirnumber · cm
number · cm
Hayır

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

front_axle_to_kingpinErişim gerekirnumber · cm
number · cm
Hayır

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

kingpin_to_rear_axleErişim gerekirnumber · cm
number · cm
Hayır

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

trailer_cog_to_rear_axleErişim gerekirnumber · cm
number · cm
Hayır

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

trailer_start_to_kingpinErişim gerekirnumber · cm
number · cm
Hayır

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

max_middle_axle_weightErişim gerekirnumber · kg
number · kg
Hayır

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

max_rear_axle_weightErişim gerekirnumber · kg
number · kg
Hayır

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

Örnek istek

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

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

Yanıtlar

  • 200OKDeğişiklikten sonraki araç.
    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.

  • 400Bad requestinvalid_json
    • invalid_jsonGövde geçerli bir JSON değil ya da bir alanın türü yanlış.
    AdTürZorunluAçıklama
    errorErrorBodyzorunlu
    ErrorBody
    Evet
    Tüm hata kodları
  • 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ı
  • 403Forbiddenpreset_read_onlyip_not_allowedsubscription_inactiveaccount_inactivescope_missing
    • preset_read_onlyHazır araçlar değiştirilemez ve silinemez.
    • 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ı
  • 422Unprocessable entityvalidation_failed
    • validation_failedİstek geçerli bir JSON ama geçersiz bir iş tanımlıyor. Tüm sorunlar details[] içinde listelenir.
    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ı