Projeyi hesapla
Projenin araçları ve öğeleri için yükleme planını tıpkı POST /v1/pack gibi hesaplar: aynı fiyat, kredi rezervasyonu, limitler, Idempotency-Key, ?wait= ve iş.
İş başarıyla tamamlandığında planı projeye kaydedilir ve proje uygulamada bu planla açılır. İş çalışırken proje değiştiyse plan yalnızca işte kalır (project_not_saved uyarısı). Sonuçtaki ID'ler projeye aittir: vehicle_id slot ID'sidir (pv_…), item_id ise öğe ID'si (item_…).
Kimlik doğrulama
Yol parametreleri
idstringzorunluProje ID'si (prj_…).
Sorgu parametreleri
waitintegerİşin bitmesi için yanıtın bekletileceği süre (saniye). Zamanında biterse: sonucu içeren 200. Aksi halde: 202.
00–60Header parametreleri
Idempotency-KeystringUUID ya da sipariş numaranız gibi benzersiz herhangi bir dize. Aynı anahtar 24 saat içinde tekrar gönderilirse yeni bir iş oluşturulup ücretlendirilmez, ilk iş döner.
Gövde parametreleri
application/jsonreferencestringReferansınız; işin yanıtında aynen geri döner. Varsayılan: proje adı.
optionsProjectPackOptionsHesaplama 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_onlyallow_overweightbooleanAraçların taşıma kapasitesi sınırlarını yok say.
max_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/projects/prj_3051/pack" \
-H "Authorization: Bearer $CARGODUO_API_KEY" \
-H "Idempotency-Key: order-1042-v1" \
-H "Content-Type: application/json" \
-d '{
"reference": "order-1042"
}'const res = await fetch("https://runner.cargoduo.com/v1/projects/prj_3051/pack", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CARGODUO_API_KEY}`,
"Idempotency-Key": "order-1042-v1",
"Content-Type": "application/json",
},
body: JSON.stringify({
"reference": "order-1042"
}),
});
const data = await res.json();
console.log(res.status, data);import os
import requests
response = requests.post(
"https://runner.cargoduo.com/v1/projects/prj_3051/pack",
headers={"Authorization": f"Bearer {os.environ['CARGODUO_API_KEY']}", "Idempotency-Key": "order-1042-v1"},
json={
"reference": "order-1042",
},
)
print(response.status_code, response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
body := strings.NewReader(`{
"reference": "order-1042"
}`)
req, err := http.NewRequest("POST", "https://runner.cargoduo.com/v1/projects/prj_3051/pack", body)
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("CARGODUO_API_KEY"))
req.Header.Set("Idempotency-Key", "order-1042-v1")
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"
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://runner.cargoduo.com/v1/projects/prj_3051/pack"))
.header("Authorization", "Bearer " + System.getenv("CARGODUO_API_KEY"))
.header("Idempotency-Key", "order-1042-v1")
.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"));
client.DefaultRequestHeaders.Add("Idempotency-Key", "order-1042-v1");
var json = """
{
"reference": "order-1042"
}
""";
var request = new HttpRequestMessage(HttpMethod.Post, "https://runner.cargoduo.com/v1/projects/prj_3051/pack")
{
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"
}
JSON;
$ch = curl_init('https://runner.cargoduo.com/v1/projects/prj_3051/pack');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('CARGODUO_API_KEY'),
'Idempotency-Key: order-1042-v1',
'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/projects/prj_3051/pack")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("CARGODUO_API_KEY")}"
request["Idempotency-Key"] = "order-1042-v1"
request["Content-Type"] = "application/json"
request.body = <<~'JSON'
{
"reference": "order-1042"
}
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
{
"id": "job_4bK9mT2xQe7LpW1zRc8VdN3f",
"object": "job",
"status": "queued",
"reference": "order-1042",
"source": "api",
"project_id": "prj_3051",
"created_at": "2026-10-19T09:12:03Z",
"started_at": null,
"finished_at": null,
"progress": {
"stage": "queued",
"vehicles_done": 0,
"placed_items": 0
},
"summary": {
"items_requested": 58,
"items_placed": 0,
"items_unplaced": 0,
"vehicles_used": 0,
"total_weight": 0,
"volume_utilization": 0,
"queue_ms": 0,
"compute_ms": 0
},
"cost": {
"credits": 0,
"reserved_credits": 1.11,
"rate_card_version": 1,
"breakdown": {
"base": 0,
"vehicles": 0,
"compute": 0,
"large_load": 0
}
},
"error": null,
"warnings": [],
"result_url": "https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result",
"pdf_url": "",
"expires_at": "2026-11-02T09:12:03Z"
}Yanıtlar
200OKİş ?wait süresi içinde bitti, sonuç yanıtın içinde. Tamamlanmış bir işin idempotent tekrarı da bu yanıtı alır.
AdTürZorunluAçıklamaidstringzorunlustringEvetİş ID'si (job_…).
objectstringzorunlustringEvetHer zaman
job.jobstatusstringzorunlustringEvetqueued→running→succeeded|failed|canceled.queuedrunningsucceededfailedcanceledreferencestringstringHayırİstekte gönderdiğiniz referans.
sourcestringstringHayırİşin oluşturulduğu yer.
apiplaygroundproject_idstringstringHayırPOST /v1/projects/{id}/pack işinin planını kaydettiği proje (prj_…). Diğer işlerde bulunmaz.
created_atstringzorunlustringEvetRFC 3339 zaman damgası.
started_atstring | nullstring | nullHayırHesaplamanın başladığı zaman (RFC 3339) ya da
null.finished_atstring | nullstring | nullHayırİşin bittiği zaman (RFC 3339) ya da
null.progressJobProgressJobProgressHayırİş sıradayken ya da çalışırken anlık ilerleme.
stagestringstringHayırGüncel aşama; örneğin
queued,running,finalizingya dadone. Yalnızca bilgi amaçlıdır: mantığınızıJob.statusalanına göre kurun.vehicles_doneintegerintegerHayırŞu ana kadar tamamlanan araç sayısı.
placed_itemsintegerintegerHayırŞu ana kadar yerleştirilen öğe adedi.
summaryJobSummaryJobSummaryHayırSayılar ve süreler.
items_requestedintegerintegerHayırToplam öğe adedi (quantity değerlerinin toplamı).
items_placedintegerintegerHayırYerleştirilen adet.
items_unplacedintegerintegerHayırYerleştirilemeyen adet.
vehicles_usedintegerintegerHayırEn az bir öğe taşıyan araçlar.
total_weightnumber · kgnumber · kgHayırYüklenen ağırlık.
volume_utilizationnumbernumberHayırKullanılan araçların ortalama hacim kullanım oranı, 0–1.
queue_msintegerintegerHayırHesaplama kapasitesi için kuyrukta geçen süre (ücretlendirilmez).
compute_msintegerintegerHayırHesaplama süresi (ücretlendirilir).
costJobCostJobCostHayırDüşülen krediler (iş bitince kesinleşir) ve iş çalışırken tutulan rezervasyon.
creditsnumber · creditsnumber · creditsHayırDüşülen krediler (iş bitene kadar 0). Başarısız işler ücretlendirilmez; tek istisna time_limit_exceeded: iptal edilen bir iş gibi ücretlendirilir.
reserved_creditsnumber · creditsnumber · creditsHayırİş sıradayken/çalışırken rezerve edilen krediler (en kötü durumdaki fiyat). İş bitince serbest bırakılır.
rate_card_versionintegerintegerHayırİşin fiyatlandırıldığı fiyat tarifesi.
breakdownCostBreakdownCostBreakdownHayırKalem kalem fiyat.
basenumber · creditsnumber · creditsHayırİş ücreti.
vehiclesnumber · creditsnumber · creditsHayırYüklenen araç başına (iptal edilen ya da time_limit_exceeded ile biten işlerde alınmaz).
computenumber · creditsnumber · creditsHayırHesaplama saniyesi başına; milisaniye bazında orantılı.
large_loadnumber · creditsnumber · creditsHayırBüyük yük eşiğinin üzerindeki her başlayan 100 öğe için ek ücret.
errorJobError | nullJobError | nullHayırİşin neden başarısız olduğu ya da iptal edildiği; aksi halde
null.codestringstringHayırMakine tarafından okunabilir kod (bkz. Hatalar).
messagestringstringHayırİngilizce açıklama.
warningsWarning[]Warning[]Hayırİstekle ilgili engelleyici olmayan uyarılar (sonuçta da yinelenir).
codestringstringHayırMakine tarafından okunabilir kod.
messagestringstringHayırİngilizce açıklama.
result_urlstringstringHayırstatusdeğerisucceededolduğunda tam sonuç için bu URL'ye GET isteği gönderin.pdf_urlstringstringHayırYükleme planını PDF olarak oluşturan tarayıcı bağlantısı (3B görünümler + yükleme adımları). expires_at zamanına kadar geçerlidir. Süresi dolunca boştur.
expires_atstringstringHayırİstek/sonuç gövdelerinin ve PDF bağlantısının silineceği zaman (RFC 3339). İşin meta verileri ve ücretleri saklanır.
resultResultResultHayırTam sonuç; yalnızca istendiğinde (?include=result) ya da POST /v1/pack?wait= zamanında bittiğinde yanıtın içinde gelir.
job_idstringstringHayırİş.
vehiclesResultVehicle[]ResultVehicle[]HayırYükleme sırasına göre yüklenen araçlar (boş araçlar dahil edilmez).
indexintegerintegerHayırPlandaki sıra, 0'dan başlar.
vehicle_idstringstringHayırAraç tanımınızın ID'si (proje işlerinde: slot ID'si, pv_…).
copyintegerintegerHayırO tanımın kopya numarası, 1'den başlar (quantity > 1 ya da auto modunda eklenmiş).
auto_addedbooleanbooleanHayırpacking_modeautoolduğu için belirttiğinizquantitydeğerine ek olarak eklendi.namestringstringHayırAraç adı.
typestringstringHayırAraç türü.
lengthnumber · cmnumber · cmHayırYük alanı uzunluğu.
widthnumber · cmnumber · cmHayırYük alanı genişliği.
heightnumber · cmnumber · cmHayırYük alanı yüksekliği.
max_weightnumber · kgnumber · kgHayırTaşıma kapasitesi.
items_placedintegerintegerHayırBu araçtaki adet.
total_weightnumber · kgnumber · kgHayırBu araçtaki ağırlık.
volume_utilizationnumbernumberHayırKullanılan hacim / yük alanı hacmi, 0–1.
weight_utilizationnumbernumberHayırtotal_weight / max_weight, 0–1 (allow_overweight ile 1'i aşabilir).
center_of_gravityPointPointHayırYükün ağırlık merkezi (cm).
xnumber · cmnumber · cmHayırynumber · cmnumber · cmHayırznumber · cmnumber · cmHayırplacementsPlacement[]Placement[]HayırBu araçtaki tüm adetler.
item_idstringstringHayırÖğe tanımınızın ID'si (proje işlerinde: öğe ID'si, item_…).
instanceintegerintegerHayırO öğe tanımı içindeki adet numarası, 1'den başlar (tüm plan genelinde benzersiz).
labelstringstringHayırÖğe etiketi.
xnumber · cmnumber · cmHayırMinimum köşenin uzunluk boyunca konumu.
ynumber · cmnumber · cmHayırMinimum köşenin zeminden yüksekliği.
znumber · cmnumber · cmHayırMinimum köşenin genişlik boyunca konumu.
lengthnumber · cmnumber · cmHayırYerleştirildiği hâliyle x ekseni boyunca boyut.
widthnumber · cmnumber · cmHayırYerleştirildiği hâliyle z ekseni boyunca boyut.
heightnumber · cmnumber · cmHayırYerleştirildiği hâliyle y ekseni boyunca boyut.
rotatedbooleanbooleanHayırTanımlandığından farklı bir yönelimle yerleştirildi.
orientationstringstringHayırTanımlı kenarlardan hangisinin x, z ve y boyunca uzandığı:
lwh= tanımlandığı gibi,wlh= dikey eksen etrafında 90° döndürülmüş,lhw,hwl,whl,hlw= yan yatırılmış.stepintegerintegerHayırAraç içindeki yükleme adımı, 1'den başlar (artan sırayla yükleyin).
weightnumber · kgnumber · kgHayırAdet ağırlığı.
axle_loadsErişim gerekirAxleLoad[]AxleLoad[]HayırAks başına yük (yalnızca aks verisi olan araçlarda).
namestringstringHayıraxle_positionssırasıylaAxle 1,Axle 2…positionnumber · cmnumber · cmHayırYük alanının önünden ölçülen aks konumu.
loadnumber · kgnumber · kgHayırAks üzerindeki yük.
maxnumber · kgnumber · kgHayırTanımlı üst sınır (0 = yok).
okbooleanbooleanHayırload≤max(üst sınır yoksa her zamantrue).unplacedUnplacedItem[]UnplacedItem[]HayırYerleştirilemeyen adetler ve nedenleri.
item_idstringstringHayırÖğe tanımınızın ID'si.
instanceintegerintegerHayırAdet numarası, 1'den başlar.
labelstringstringHayırÖğe etiketi.
reasonstringstringHayırNeden yerleştirilemediği.
warningsWarning[]Warning[]HayırPlanla ilgili uyarılar.
codestringstringHayırMakine tarafından okunabilir kod.
messagestringstringHayırİngilizce açıklama.
pdf_urlstringstringHayırPlanı PDF olarak oluşturan tarayıcı bağlantısı.
expires_atstringstringHayırBu sonucun silineceği zaman (RFC 3339).
202Acceptedİş kabul edildi (sırada ya da çalışıyor).
AdTürZorunluAçıklamaidstringzorunlustringEvetİş ID'si (job_…).
objectstringzorunlustringEvetHer zaman
job.jobstatusstringzorunlustringEvetqueued→running→succeeded|failed|canceled.queuedrunningsucceededfailedcanceledreferencestringstringHayırİstekte gönderdiğiniz referans.
sourcestringstringHayırİşin oluşturulduğu yer.
apiplaygroundproject_idstringstringHayırPOST /v1/projects/{id}/pack işinin planını kaydettiği proje (prj_…). Diğer işlerde bulunmaz.
created_atstringzorunlustringEvetRFC 3339 zaman damgası.
started_atstring | nullstring | nullHayırHesaplamanın başladığı zaman (RFC 3339) ya da
null.finished_atstring | nullstring | nullHayırİşin bittiği zaman (RFC 3339) ya da
null.progressJobProgressJobProgressHayırİş sıradayken ya da çalışırken anlık ilerleme.
stagestringstringHayırGüncel aşama; örneğin
queued,running,finalizingya dadone. Yalnızca bilgi amaçlıdır: mantığınızıJob.statusalanına göre kurun.vehicles_doneintegerintegerHayırŞu ana kadar tamamlanan araç sayısı.
placed_itemsintegerintegerHayırŞu ana kadar yerleştirilen öğe adedi.
summaryJobSummaryJobSummaryHayırSayılar ve süreler.
items_requestedintegerintegerHayırToplam öğe adedi (quantity değerlerinin toplamı).
items_placedintegerintegerHayırYerleştirilen adet.
items_unplacedintegerintegerHayırYerleştirilemeyen adet.
vehicles_usedintegerintegerHayırEn az bir öğe taşıyan araçlar.
total_weightnumber · kgnumber · kgHayırYüklenen ağırlık.
volume_utilizationnumbernumberHayırKullanılan araçların ortalama hacim kullanım oranı, 0–1.
queue_msintegerintegerHayırHesaplama kapasitesi için kuyrukta geçen süre (ücretlendirilmez).
compute_msintegerintegerHayırHesaplama süresi (ücretlendirilir).
costJobCostJobCostHayırDüşülen krediler (iş bitince kesinleşir) ve iş çalışırken tutulan rezervasyon.
creditsnumber · creditsnumber · creditsHayırDüşülen krediler (iş bitene kadar 0). Başarısız işler ücretlendirilmez; tek istisna time_limit_exceeded: iptal edilen bir iş gibi ücretlendirilir.
reserved_creditsnumber · creditsnumber · creditsHayırİş sıradayken/çalışırken rezerve edilen krediler (en kötü durumdaki fiyat). İş bitince serbest bırakılır.
rate_card_versionintegerintegerHayırİşin fiyatlandırıldığı fiyat tarifesi.
breakdownCostBreakdownCostBreakdownHayırKalem kalem fiyat.
basenumber · creditsnumber · creditsHayırİş ücreti.
vehiclesnumber · creditsnumber · creditsHayırYüklenen araç başına (iptal edilen ya da time_limit_exceeded ile biten işlerde alınmaz).
computenumber · creditsnumber · creditsHayırHesaplama saniyesi başına; milisaniye bazında orantılı.
large_loadnumber · creditsnumber · creditsHayırBüyük yük eşiğinin üzerindeki her başlayan 100 öğe için ek ücret.
errorJobError | nullJobError | nullHayırİşin neden başarısız olduğu ya da iptal edildiği; aksi halde
null.codestringstringHayırMakine tarafından okunabilir kod (bkz. Hatalar).
messagestringstringHayırİngilizce açıklama.
warningsWarning[]Warning[]Hayırİstekle ilgili engelleyici olmayan uyarılar (sonuçta da yinelenir).
codestringstringHayırMakine tarafından okunabilir kod.
messagestringstringHayırİngilizce açıklama.
result_urlstringstringHayırstatusdeğerisucceededolduğunda tam sonuç için bu URL'ye GET isteği gönderin.pdf_urlstringstringHayırYükleme planını PDF olarak oluşturan tarayıcı bağlantısı (3B görünümler + yükleme adımları). expires_at zamanına kadar geçerlidir. Süresi dolunca boştur.
expires_atstringstringHayırİstek/sonuç gövdelerinin ve PDF bağlantısının silineceği zaman (RFC 3339). İşin meta verileri ve ücretleri saklanır.
resultResultResultHayırTam sonuç; yalnızca istendiğinde (?include=result) ya da POST /v1/pack?wait= zamanında bittiğinde yanıtın içinde gelir.
job_idstringstringHayırİş.
vehiclesResultVehicle[]ResultVehicle[]HayırYükleme sırasına göre yüklenen araçlar (boş araçlar dahil edilmez).
indexintegerintegerHayırPlandaki sıra, 0'dan başlar.
vehicle_idstringstringHayırAraç tanımınızın ID'si (proje işlerinde: slot ID'si, pv_…).
copyintegerintegerHayırO tanımın kopya numarası, 1'den başlar (quantity > 1 ya da auto modunda eklenmiş).
auto_addedbooleanbooleanHayırpacking_modeautoolduğu için belirttiğinizquantitydeğerine ek olarak eklendi.namestringstringHayırAraç adı.
typestringstringHayırAraç türü.
lengthnumber · cmnumber · cmHayırYük alanı uzunluğu.
widthnumber · cmnumber · cmHayırYük alanı genişliği.
heightnumber · cmnumber · cmHayırYük alanı yüksekliği.
max_weightnumber · kgnumber · kgHayırTaşıma kapasitesi.
items_placedintegerintegerHayırBu araçtaki adet.
total_weightnumber · kgnumber · kgHayırBu araçtaki ağırlık.
volume_utilizationnumbernumberHayırKullanılan hacim / yük alanı hacmi, 0–1.
weight_utilizationnumbernumberHayırtotal_weight / max_weight, 0–1 (allow_overweight ile 1'i aşabilir).
center_of_gravityPointPointHayırYükün ağırlık merkezi (cm).
xnumber · cmnumber · cmHayırynumber · cmnumber · cmHayırznumber · cmnumber · cmHayırplacementsPlacement[]Placement[]HayırBu araçtaki tüm adetler.
item_idstringstringHayırÖğe tanımınızın ID'si (proje işlerinde: öğe ID'si, item_…).
instanceintegerintegerHayırO öğe tanımı içindeki adet numarası, 1'den başlar (tüm plan genelinde benzersiz).
labelstringstringHayırÖğe etiketi.
xnumber · cmnumber · cmHayırMinimum köşenin uzunluk boyunca konumu.
ynumber · cmnumber · cmHayırMinimum köşenin zeminden yüksekliği.
znumber · cmnumber · cmHayırMinimum köşenin genişlik boyunca konumu.
lengthnumber · cmnumber · cmHayırYerleştirildiği hâliyle x ekseni boyunca boyut.
widthnumber · cmnumber · cmHayırYerleştirildiği hâliyle z ekseni boyunca boyut.
heightnumber · cmnumber · cmHayırYerleştirildiği hâliyle y ekseni boyunca boyut.
rotatedbooleanbooleanHayırTanımlandığından farklı bir yönelimle yerleştirildi.
orientationstringstringHayırTanımlı kenarlardan hangisinin x, z ve y boyunca uzandığı:
lwh= tanımlandığı gibi,wlh= dikey eksen etrafında 90° döndürülmüş,lhw,hwl,whl,hlw= yan yatırılmış.stepintegerintegerHayırAraç içindeki yükleme adımı, 1'den başlar (artan sırayla yükleyin).
weightnumber · kgnumber · kgHayırAdet ağırlığı.
axle_loadsErişim gerekirAxleLoad[]AxleLoad[]HayırAks başına yük (yalnızca aks verisi olan araçlarda).
namestringstringHayıraxle_positionssırasıylaAxle 1,Axle 2…positionnumber · cmnumber · cmHayırYük alanının önünden ölçülen aks konumu.
loadnumber · kgnumber · kgHayırAks üzerindeki yük.
maxnumber · kgnumber · kgHayırTanımlı üst sınır (0 = yok).
okbooleanbooleanHayırload≤max(üst sınır yoksa her zamantrue).unplacedUnplacedItem[]UnplacedItem[]HayırYerleştirilemeyen adetler ve nedenleri.
item_idstringstringHayırÖğe tanımınızın ID'si.
instanceintegerintegerHayırAdet numarası, 1'den başlar.
labelstringstringHayırÖğe etiketi.
reasonstringstringHayırNeden yerleştirilemediği.
warningsWarning[]Warning[]HayırPlanla ilgili uyarılar.
codestringstringHayırMakine tarafından okunabilir kod.
messagestringstringHayırİngilizce açıklama.
pdf_urlstringstringHayırPlanı PDF olarak oluşturan tarayıcı bağlantısı.
expires_atstringstringHayırBu sonucun silineceği zaman (RFC 3339).
400Bad request
invalid_jsonidempotency_key_invalidinvalid_jsonGövde geçerli bir JSON değil ya da bir alanın türü yanlış.idempotency_key_invalidIdempotency-Key header'ı 128 karakterden uzun.
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.
402Payment required
insufficient_creditsinsufficient_creditsKullanılabilir krediler, bu işin olabilecek en düşük maliyetini bile karşılamı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.
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.
404Not found
project_not_foundproject_not_foundOrganizasyonunuzda bu ID'ye sahip bir proje yok.
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.
409Conflict
project_busyproject_busyProje şu anda hesaplanıyor (uygulamada ya da başka bir iş tarafından).
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.
422Unprocessable entity
validation_failedvalidation_failedİstek geçerli bir JSON ama geçersiz bir iş tanımlıyor. Tüm sorunlar details[] içinde listelenir.
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
too_many_jobsrate_limitedtoo_many_jobsOrganizasyonun sıradaki + çalışan iş sayısı zaten üst sınırda.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ı.
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.