Maliyet tahmini al
POST /v1/pack ile aynı doğrulamayı yapar ve fiyat aralığını döndürür; iş oluşturmaz, kredi rezerve etmez.
Ücretsiz. Geçersiz bir istek de 200 döner; yanıtta valid: false bulunur ve tüm sorunlar errors[] içinde listelenir.
Kimlik doğrulama
Gövde parametreleri
application/jsonreferencestringKendi referansınız (sipariş numarası, sevkiyat ID'si…). İşin yanıtında aynen geri döner.
vehiclesVehicle[]zorunluAraç tanımları. Her birinde quantity > 1 olabilir. En az bir tane gerekir.
idstringİstek içinde benzersiz, size ait tanımlayıcı. Sonuçlarda vehicle_id olarak geçer. Varsayılan: vehicle_id.
vehicle_idstringGET /v1/vehicles listesinden bir araç ID'si: hazır araç ya da organizasyonunuzun araçlarından biri (veh_…). Tür, ad, ölçüler, taşıma kapasitesi ve diğer tüm kayıtlı değerleri sağlar.
typestringAraç türü. vehicle_id verilmediyse zorunludur. Yalnızca GET /v1/limits yanıtında listelenen türler (allowed_vehicle_types) kabul edilir.
trucktrailerflatbedcontainerpalletaircraftshipnamestringGörüntülenen ad (varsayılan: kayıtlı aracın adı ya da ID).
lengthnumber · cmYük alanının iç uzunluğu, x ekseni boyunca (ön duvardan kapıya doğru). vehicle_id verilmediyse zorunludur.
widthnumber · cmYük alanının iç genişliği, z ekseni boyunca. vehicle_id verilmediyse zorunludur.
heightnumber · cmYük alanının iç yüksekliği, y ekseni boyunca. vehicle_id verilmediyse zorunludur.
max_weightnumber · kgAzami taşıma kapasitesi. vehicle_id verilmediyse zorunludur.
quantityintegerBu tanımdan kaç özdeş aracın kullanılabildiği.
11–100floor_load_capacitynumber · kg/m²Zemin taşıma kapasitesi: 0 ya da daha fazla (0 = sınır yok).
aux_deckbooleanAracın ikinci bir katı var (çift katlı).
falseaux_deck_heightnumber · cmİkinci katın zeminden yüksekliği. aux_deck değeri true ise zorunludur.
aux_deck_max_weightnumber · kgİkinci katın yük sınırı. aux_deck değeri true ise zorunludur.
blocked_areasRect[]Üzerine hiçbir şey konamayacak zemin bölgeleri (tekerlek davlumbazları, hasarlı yerler, ayrılmış alanlar). Her biri araç zemininin içinde olmalıdır.
xnumber · cmzorunluÖn duvardan dikdörtgenin yakın kenarına uzaklık.
znumber · cmzorunluSağ duvardan (z = 0; kapıdan içeri bakıldığında sağ) dikdörtgenin yakın kenarına uzaklık.
lengthnumber · cmzorunlux ekseni boyunca boyut.
widthnumber · cmzorunluz ekseni boyunca boyut.
axle_positionsErişim gerekirnumber[] · cmYü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_loadsErişim gerekirnumber[] · kgaxle_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_xErişim gerekirnumber · cmAğırlık merkezinin uzunluğun ortasından izin verilen sapması: 0 ile uzunluk / 2 arası.
cog_range_yErişim gerekirnumber · cmAğırlık merkezinin genişliğin ortasından izin verilen sapması: 0 ile genişlik / 2 arası.
tractor_weightErişim gerekirnumber · kgÇekici-dorse aks modeli: çekici kütlesi.
empty_trailer_weightErişim gerekirnumber · kgÇekici-dorse aks modeli: boş dorse kütlesi.
front_axle_to_middle_axleErişim gerekirnumber · cmÇekici-dorse aks modeli: çekicinin ön aksından tahrik (orta) aksına mesafe.
front_axle_to_tractor_cogErişim gerekirnumber · cmÇekici-dorse aks modeli: ön akstan çekicinin ağırlık merkezine mesafe.
front_axle_to_kingpinErişim gerekirnumber · cmÇekici-dorse aks modeli: ön akstan kingpin'e (beşinci teker) mesafe.
kingpin_to_rear_axleErişim gerekirnumber · cmÇekici-dorse aks modeli: kingpin'den dorsenin arka aks grubuna mesafe.
trailer_cog_to_rear_axleErişim gerekirnumber · cmÇekici-dorse aks modeli: dorsenin ağırlık merkezinden arka aks grubuna mesafe.
trailer_start_to_kingpinErişim gerekirnumber · cmÇekici-dorse aks modeli: dorsenin ön ucundan kingpin'e mesafe.
max_middle_axle_weightErişim gerekirnumber · kgÇekici-dorse aks modeli: tahrik (orta) aksı için yasal sınır.
max_rear_axle_weightErişim gerekirnumber · kgÇekici-dorse aks modeli: arka aks grubu için yasal sınır.
itemsItem[]zorunluÖğe tanımları. Her birinde quantity > 1 olabilir. En az bir tane gerekir.
idstringİstek içinde benzersiz, size ait tanımlayıcı. Sonuçlarda item_id olarak geçer. Varsayılan: template_id.
template_idstringBir şablon ID'si (tpl_…); liste için bkz. GET /v1/templates. Öğenin tüm alanlarını sağlar; yanında gönderilen alanlar bunları geçersiz kılar.
labelstringGörüntülenen etiket (varsayılan: ID).
shapestringÖğe şekli. cylinder ve drum, length + width yerine radius + height kullanır; pallet ve drum her zaman dik durur.
boxcylinderpalletbagdrumVarsayılan "box"lengthnumber · cmUzunluk. shape değeri cylinder ya da drum değilse zorunludur.
widthnumber · cmGenişlik. shape değeri cylinder ya da drum değilse zorunludur.
heightnumber · cmzorunluYükseklik (öğe tanımlandığı gibi dururken dikey kenar).
radiusnumber · cmYarıçap. shape değeri cylinder ya da drum ise zorunludur.
weightnumber · kgzorunluTEK bir adedin ağırlığı.
quantityintegerÖzdeş adet sayısı.
11–10000stackablebooleanBu öğenin üzerine başka öğeler konabilir.
truemax_stack_weightnumber · kgTek bir adedin üzerine binebilecek en fazla ağırlık. 0 = sınırsız.
0rotationstringall = altı yönelimden herhangi biri; upright = yalnızca dikey eksen etrafında döndürülebilir (bu taraf yukarı); fixed = hiç döndürülmez.
alluprightfixedVarsayılan "all"hazardousbooleanTehlikeli madde: alt seviyelerde tutulur ve diğer tehlikeli öğelerden ayrı yerleştirilir.
falsepriorityintegerYükleme önceliği. Yüksek = önce yüklenir ve yer kalmadığında öncelikle korunur. 0 = yok.
0groupstringBu öğenin ait olduğu grubun adı (bkz. groups ve options.group_routing).
colorstring#rrggbb biçiminde görüntüleme rengi (yalnızca 3B görünüm ve PDF için).
nesting_heightnumber · cmÖzdeş adetler istiflendiğinde iç içe geçen yükseklik (iç içe geçen kasalar, kovalar).
0groupsGroup[]İsteğe bağlı gruplar (müşteriler, duraklar, siparişler). options.group_routing değeri "none" değilse, öğelerin adını verdiği her grup için zorunludur; aksi halde gruplar, öğelerdeki grup adlarından görülme sırasına göre oluşturulur.
namestringzorunluGrup adı; Item.group bu ada başvurur.
orderintegerYükleme sırası (düşük = önce yüklenir). Varsayılan: listedeki konumu.
colorstring#rrggbb biçiminde görüntüleme rengi.
optionsOptionsYükleme seçenekleri. Tüm alanlar isteğe bağlıdır.
packing_modestringauto = listelenen araçlar dolunca en uygun araçtan yeni kopyalar eklenir (işin araç limitine kadar); fleet_only = yalnızca listelenen araçlar kullanılır, sığmayan her şey yerleştirilemeyenler arasında raporlanır.
autofleet_onlyVarsayılan "auto"group_routingstringnone = gruplar yalnızca bilgi amaçlıdır; wall = her grup aracın kendine ait bir bölümüne yüklenir; routing = gruplar sırayla yüklenir, sonraki bir grup önceki grubun üstüne ya da yanına gelebilir ama asla altına gelemez (çok duraklı teslimat); no_stack = gruplar sırayla yan yana yüklenir, asla üst üste gelmez.
nonewallroutingno_stackVarsayılan "none"allow_overweightbooleanAraçların taşıma kapasitesi sınırlarını yok say.
falsemax_stack_itemsintegerBir istifteki en fazla öğe sayısı. 0 = sınırsız.
0max_stack_density_kg_m2number · kg/m²Zemin alanı başına en fazla istif ağırlığı. 0 = sınırsız.
0lock_rotationsbooleanAraç yüksekliğine sığan ilk yönelimi koru.
falsegroup_identical_binsbooleanÖzdeş araçları tek bir havuz olarak ele al.
falsetime_limitnumber · sİşin tamamı için hesaplama süresinin üst sınırı. 0 = otomatik (GET /v1/limits yanıtındaki max_time_limit_seconds ile sınırlı). Sınıra ulaşıldığında o ana kadar bulunan en iyi plan döner. Yalnızca gerçekten kullanılan hesaplama süresi için ödeme yaparsınız.
0enforce_axleErişim gerekirbooleanAks modelinin on alanının tamamı tanımlı olan araçlarda, bir aks grubuna aşırı yük bindiren yerleşimleri reddet.
falseÖrnek istek
curl -X POST "https://runner.cargoduo.com/v1/estimate" \
-H "Authorization: Bearer $CARGODUO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"reference": "order-1042",
"vehicles": [
{
"id": "trailer",
"type": "trailer",
"name": "13.6 m trailer",
"length": 1360,
"width": 245,
"height": 270,
"max_weight": 24000
}
],
"items": [
{
"id": "pallet-eu",
"label": "Euro pallet",
"length": 120,
"width": 80,
"height": 140,
"weight": 450,
"quantity": 18,
"stackable": false
},
{
"id": "carton-a",
"label": "Carton A",
"length": 60,
"width": 40,
"height": 40,
"weight": 12,
"quantity": 40,
"rotation": "upright"
}
],
"options": {
"packing_mode": "auto"
}
}'const res = await fetch("https://runner.cargoduo.com/v1/estimate", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CARGODUO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"reference": "order-1042",
"vehicles": [
{
"id": "trailer",
"type": "trailer",
"name": "13.6 m trailer",
"length": 1360,
"width": 245,
"height": 270,
"max_weight": 24000
}
],
"items": [
{
"id": "pallet-eu",
"label": "Euro pallet",
"length": 120,
"width": 80,
"height": 140,
"weight": 450,
"quantity": 18,
"stackable": false
},
{
"id": "carton-a",
"label": "Carton A",
"length": 60,
"width": 40,
"height": 40,
"weight": 12,
"quantity": 40,
"rotation": "upright"
}
],
"options": {
"packing_mode": "auto"
}
}),
});
const data = await res.json();
console.log(res.status, data);import os
import requests
response = requests.post(
"https://runner.cargoduo.com/v1/estimate",
headers={"Authorization": f"Bearer {os.environ['CARGODUO_API_KEY']}"},
json={
"reference": "order-1042",
"vehicles": [
{
"id": "trailer",
"type": "trailer",
"name": "13.6 m trailer",
"length": 1360,
"width": 245,
"height": 270,
"max_weight": 24000,
},
],
"items": [
{
"id": "pallet-eu",
"label": "Euro pallet",
"length": 120,
"width": 80,
"height": 140,
"weight": 450,
"quantity": 18,
"stackable": False,
},
{
"id": "carton-a",
"label": "Carton A",
"length": 60,
"width": 40,
"height": 40,
"weight": 12,
"quantity": 40,
"rotation": "upright",
},
],
"options": {
"packing_mode": "auto",
},
},
)
print(response.status_code, response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
body := strings.NewReader(`{
"reference": "order-1042",
"vehicles": [
{
"id": "trailer",
"type": "trailer",
"name": "13.6 m trailer",
"length": 1360,
"width": 245,
"height": 270,
"max_weight": 24000
}
],
"items": [
{
"id": "pallet-eu",
"label": "Euro pallet",
"length": 120,
"width": 80,
"height": 140,
"weight": 450,
"quantity": 18,
"stackable": false
},
{
"id": "carton-a",
"label": "Carton A",
"length": 60,
"width": 40,
"height": 40,
"weight": 12,
"quantity": 40,
"rotation": "upright"
}
],
"options": {
"packing_mode": "auto"
}
}`)
req, err := http.NewRequest("POST", "https://runner.cargoduo.com/v1/estimate", body)
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("CARGODUO_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode, string(out))
}import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
String body = """
{
"reference": "order-1042",
"vehicles": [
{
"id": "trailer",
"type": "trailer",
"name": "13.6 m trailer",
"length": 1360,
"width": 245,
"height": 270,
"max_weight": 24000
}
],
"items": [
{
"id": "pallet-eu",
"label": "Euro pallet",
"length": 120,
"width": 80,
"height": 140,
"weight": 450,
"quantity": 18,
"stackable": false
},
{
"id": "carton-a",
"label": "Carton A",
"length": 60,
"width": 40,
"height": 40,
"weight": 12,
"quantity": 40,
"rotation": "upright"
}
],
"options": {
"packing_mode": "auto"
}
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://runner.cargoduo.com/v1/estimate"))
.header("Authorization", "Bearer " + System.getenv("CARGODUO_API_KEY"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("CARGODUO_API_KEY"));
var json = """
{
"reference": "order-1042",
"vehicles": [
{
"id": "trailer",
"type": "trailer",
"name": "13.6 m trailer",
"length": 1360,
"width": 245,
"height": 270,
"max_weight": 24000
}
],
"items": [
{
"id": "pallet-eu",
"label": "Euro pallet",
"length": 120,
"width": 80,
"height": 140,
"weight": 450,
"quantity": 18,
"stackable": false
},
{
"id": "carton-a",
"label": "Carton A",
"length": 60,
"width": 40,
"height": 40,
"weight": 12,
"quantity": 40,
"rotation": "upright"
}
],
"options": {
"packing_mode": "auto"
}
}
""";
var request = new HttpRequestMessage(HttpMethod.Post, "https://runner.cargoduo.com/v1/estimate")
{
Content = new StringContent(json, Encoding.UTF8, "application/json"),
};
var response = await client.SendAsync(request);
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");<?php
$payload = <<<'JSON'
{
"reference": "order-1042",
"vehicles": [
{
"id": "trailer",
"type": "trailer",
"name": "13.6 m trailer",
"length": 1360,
"width": 245,
"height": 270,
"max_weight": 24000
}
],
"items": [
{
"id": "pallet-eu",
"label": "Euro pallet",
"length": 120,
"width": 80,
"height": 140,
"weight": 450,
"quantity": 18,
"stackable": false
},
{
"id": "carton-a",
"label": "Carton A",
"length": 60,
"width": 40,
"height": 40,
"weight": 12,
"quantity": 40,
"rotation": "upright"
}
],
"options": {
"packing_mode": "auto"
}
}
JSON;
$ch = curl_init('https://runner.cargoduo.com/v1/estimate');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('CARGODUO_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), ' ', $response, PHP_EOL;require "net/http"
require "uri"
uri = URI("https://runner.cargoduo.com/v1/estimate")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("CARGODUO_API_KEY")}"
request["Content-Type"] = "application/json"
request.body = <<~'JSON'
{
"reference": "order-1042",
"vehicles": [
{
"id": "trailer",
"type": "trailer",
"name": "13.6 m trailer",
"length": 1360,
"width": 245,
"height": 270,
"max_weight": 24000
}
],
"items": [
{
"id": "pallet-eu",
"label": "Euro pallet",
"length": 120,
"width": 80,
"height": 140,
"weight": 450,
"quantity": 18,
"stackable": false
},
{
"id": "carton-a",
"label": "Carton A",
"length": 60,
"width": 40,
"height": 40,
"weight": 12,
"quantity": 40,
"rotation": "upright"
}
],
"options": {
"packing_mode": "auto"
}
}
JSON
response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") do |http|
http.request(request)
end
puts response.code, response.bodyÖrnek yanıt
{
"valid": true,
"errors": [],
"warnings": [],
"items": 58,
"max_vehicles": 3,
"estimated_cost": {
"min_credits": 0.26,
"max_credits": 1.11
},
"estimated_seconds": 90,
"balance": {
"available_credits": 147.75
}
}Yanıtlar
200OKDoğrulama sonucu ve fiyat aralığı.
AdTürZorunluAçıklamavalidbooleanbooleanHayırİsteğin şu endpoint tarafından kabul edilip edilmeyeceği: POST /v1/pack.
errorsErrorDetail[]ErrorDetail[]HayırDoğrulama hataları (istek geçerliyse boş).
pathstringstringHayırHatalı alanın JSON yolu, ör. items[3].length.
codestringstringHayırOlası kodlar:
required,invalid_value,out_of_range,duplicate_id,unknown_vehicle,unknown_template,type_not_allowed,unknown_group,does_not_fit,too_many_items,too_many_vehicles,unknown_field,invalid_json.messagestringstringHayırİngilizce açıklama.
warningsWarning[]Warning[]HayırEngelleyici olmayan uyarılar.
codestringstringHayırMakine tarafından okunabilir kod.
messagestringstringHayırİngilizce açıklama.
itemsintegerintegerHayırToplam öğe adedi.
max_vehiclesintegerintegerHayırİşin yükleyebileceği en fazla araç sayısı.
estimated_costCostRangeCostRangeHayırKredi cinsinden fiyat aralığı.
min_creditsnumber · creditsnumber · creditsHayırOlası en düşük fiyat (en az araç, hesaplama süresi yok).
max_creditsnumber · creditsnumber · creditsHayırEn kötü durum: max_vehicles kadar araç yüklenir ve hesaplama süresi sınırının tamamı kullanılır. POST /v1/pack bu tutarı rezerve eder.
estimated_secondsnumber · snumber · sHayırİşe ayrılacak hesaplama süresi sınırı (bir üst sınırdır; çoğu iş daha erken biter).
balanceEstimateBalanceEstimateBalanceHayırKullanılabilir kredileriniz.
available_creditsnumber · creditsnumber · creditsHayır400Bad request
invalid_jsoninvalid_jsonGövde geçerli bir JSON değil ya da bir alanın türü yanlış.
Tüm hata kodlarıAdTürZorunluAçıklamaerrorErrorBodyzorunluErrorBodyEvetcodestringzorunlustringEvetMakine tarafından okunabilir kod (snake_case). Hata işleme mantığınızı asla
messagealanına göre değil, bu koda göre kurun.messagestringzorunlustringEvetİngilizce açıklama.
request_idstringzorunlustringEvetX-Request-Id header'ıyla aynı. Destek ekibine başvururken bu değeri iletin.
detailsErrorDetail[]ErrorDetail[]HayırAlan bazında sorunlar (
validation_failed).pathstringstringHayırHatalı alanın JSON yolu, ör. items[3].length.
codestringstringHayırOlası kodlar:
required,invalid_value,out_of_range,duplicate_id,unknown_vehicle,unknown_template,type_not_allowed,unknown_group,does_not_fit,too_many_items,too_many_vehicles,unknown_field,invalid_json.messagestringstringHayırİngilizce açıklama.
401Unauthorized
unauthorizedkey_revokedkey_expiredunauthorizedAPI anahtarı eksik, hatalı biçimde ya da tanınmıyor.key_revokedAnahtar iptal edildi.key_expiredAnahtarın geçerlilik süresi doldu.
Tüm hata kodlarıAdTürZorunluAçıklamaerrorErrorBodyzorunluErrorBodyEvetcodestringzorunlustringEvetMakine tarafından okunabilir kod (snake_case). Hata işleme mantığınızı asla
messagealanına göre değil, bu koda göre kurun.messagestringzorunlustringEvetİngilizce açıklama.
request_idstringzorunlustringEvetX-Request-Id header'ıyla aynı. Destek ekibine başvururken bu değeri iletin.
detailsErrorDetail[]ErrorDetail[]HayırAlan bazında sorunlar (
validation_failed).pathstringstringHayırHatalı alanın JSON yolu, ör. items[3].length.
codestringstringHayırOlası kodlar:
required,invalid_value,out_of_range,duplicate_id,unknown_vehicle,unknown_template,type_not_allowed,unknown_group,does_not_fit,too_many_items,too_many_vehicles,unknown_field,invalid_json.messagestringstringHayırİngilizce açıklama.
403Forbidden
ip_not_allowedsubscription_inactiveaccount_inactivescope_missingip_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.
Tüm hata kodlarıAdTürZorunluAçıklamaerrorErrorBodyzorunluErrorBodyEvetcodestringzorunlustringEvetMakine tarafından okunabilir kod (snake_case). Hata işleme mantığınızı asla
messagealanına göre değil, bu koda göre kurun.messagestringzorunlustringEvetİngilizce açıklama.
request_idstringzorunlustringEvetX-Request-Id header'ıyla aynı. Destek ekibine başvururken bu değeri iletin.
detailsErrorDetail[]ErrorDetail[]HayırAlan bazında sorunlar (
validation_failed).pathstringstringHayırHatalı alanın JSON yolu, ör. items[3].length.
codestringstringHayırOlası kodlar:
required,invalid_value,out_of_range,duplicate_id,unknown_vehicle,unknown_template,type_not_allowed,unknown_group,does_not_fit,too_many_items,too_many_vehicles,unknown_field,invalid_json.messagestringstringHayırİngilizce açıklama.
413Payload too large
payload_too_largepayload_too_largeİstek gövdesi 10 MB sınırını aşıyor.
Tüm hata kodlarıAdTürZorunluAçıklamaerrorErrorBodyzorunluErrorBodyEvetcodestringzorunlustringEvetMakine tarafından okunabilir kod (snake_case). Hata işleme mantığınızı asla
messagealanına göre değil, bu koda göre kurun.messagestringzorunlustringEvetİngilizce açıklama.
request_idstringzorunlustringEvetX-Request-Id header'ıyla aynı. Destek ekibine başvururken bu değeri iletin.
detailsErrorDetail[]ErrorDetail[]HayırAlan bazında sorunlar (
validation_failed).pathstringstringHayırHatalı alanın JSON yolu, ör. items[3].length.
codestringstringHayırOlası kodlar:
required,invalid_value,out_of_range,duplicate_id,unknown_vehicle,unknown_template,type_not_allowed,unknown_group,does_not_fit,too_many_items,too_many_vehicles,unknown_field,invalid_json.messagestringstringHayırİngilizce açıklama.
429Too many requests
rate_limitedrate_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ı.
Tüm hata kodlarıAdTürZorunluAçıklamaerrorErrorBodyzorunluErrorBodyEvetcodestringzorunlustringEvetMakine tarafından okunabilir kod (snake_case). Hata işleme mantığınızı asla
messagealanına göre değil, bu koda göre kurun.messagestringzorunlustringEvetİngilizce açıklama.
request_idstringzorunlustringEvetX-Request-Id header'ıyla aynı. Destek ekibine başvururken bu değeri iletin.
detailsErrorDetail[]ErrorDetail[]HayırAlan bazında sorunlar (
validation_failed).pathstringstringHayırHatalı alanın JSON yolu, ör. items[3].length.
codestringstringHayırOlası kodlar:
required,invalid_value,out_of_range,duplicate_id,unknown_vehicle,unknown_template,type_not_allowed,unknown_group,does_not_fit,too_many_items,too_many_vehicles,unknown_field,invalid_json.messagestringstringHayırİngilizce açıklama.
500Internal server error
internal_errorinternal_errorBizim tarafımızda bir hata oluştu.
Tüm hata kodlarıAdTürZorunluAçıklamaerrorErrorBodyzorunluErrorBodyEvetcodestringzorunlustringEvetMakine tarafından okunabilir kod (snake_case). Hata işleme mantığınızı asla
messagealanına göre değil, bu koda göre kurun.messagestringzorunlustringEvetİngilizce açıklama.
request_idstringzorunlustringEvetX-Request-Id header'ıyla aynı. Destek ekibine başvururken bu değeri iletin.
detailsErrorDetail[]ErrorDetail[]HayırAlan bazında sorunlar (
validation_failed).pathstringstringHayırHatalı alanın JSON yolu, ör. items[3].length.
codestringstringHayırOlası kodlar:
required,invalid_value,out_of_range,duplicate_id,unknown_vehicle,unknown_template,type_not_allowed,unknown_group,does_not_fit,too_many_items,too_many_vehicles,unknown_field,invalid_json.messagestringstringHayırİngilizce açıklama.
503Service unavailable
api_disabledapi_disabledAPI geçici olarak devre dışı (bakım) ya da organizasyon için kapatılmış.
Tüm hata kodlarıAdTürZorunluAçıklamaerrorErrorBodyzorunluErrorBodyEvetcodestringzorunlustringEvetMakine tarafından okunabilir kod (snake_case). Hata işleme mantığınızı asla
messagealanına göre değil, bu koda göre kurun.messagestringzorunlustringEvetİngilizce açıklama.
request_idstringzorunlustringEvetX-Request-Id header'ıyla aynı. Destek ekibine başvururken bu değeri iletin.
detailsErrorDetail[]ErrorDetail[]HayırAlan bazında sorunlar (
validation_failed).pathstringstringHayırHatalı alanın JSON yolu, ör. items[3].length.
codestringstringHayırOlası kodlar:
required,invalid_value,out_of_range,duplicate_id,unknown_vehicle,unknown_template,type_not_allowed,unknown_group,does_not_fit,too_many_items,too_many_vehicles,unknown_field,invalid_json.messagestringstringHayırİngilizce açıklama.