Geliştirici dokümanlarıAPI referansıİşler

İş sonucunu getir

Başarıyla tamamlanan bir işin yükleme planı: kullanılan tüm araçlar, tüm yerleşimler, sığmayan öğeler ve PDF bağlantısı.

GEThttps://runner.cargoduo.com/v1/jobs/{id}/result

Kimlik doğrulama

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

Yol parametreleri

AdTürZorunluAçıklama

idstringzorunlu

string

Evet

İş ID'si (job_…).

Örnek istek

curl -X GET "https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result" \
  -H "Authorization: Bearer $CARGODUO_API_KEY"

const res = await fetch("https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.CARGODUO_API_KEY}`,
  },
});

const data = await res.json();
console.log(res.status, data);

import os
import requests

response = requests.get(
    "https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result",
    headers={"Authorization": f"Bearer {os.environ['CARGODUO_API_KEY']}"},
)
print(response.status_code, response.json())

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("CARGODUO_API_KEY"))

	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 {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result"))
            .header("Authorization", "Bearer " + System.getenv("CARGODUO_API_KEY"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .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 request = new HttpRequestMessage(HttpMethod.Get, "https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result");
var response = await client.SendAsync(request);
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");

<?php

$ch = curl_init('https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CARGODUO_API_KEY'),
    ],
]);

$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/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("CARGODUO_API_KEY")}"

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

200 OK · Result

{
  "job_id": "job_4bK9mT2xQe7LpW1zRc8VdN3f",
  "vehicles": [
    {
      "index": 0,
      "vehicle_id": "trailer",
      "copy": 1,
      "auto_added": false,
      "name": "13.6 m trailer",
      "type": "trailer",
      "length": 1360,
      "width": 245,
      "height": 270,
      "max_weight": 24000,
      "items_placed": 58,
      "total_weight": 8580,
      "volume_utilization": 0.3116,
      "weight_utilization": 0.3575,
      "center_of_gravity": {
        "x": 452.6,
        "y": 68.4,
        "z": 121.8
      },
      "axle_loads": [],
      "placements": [
        {
          "item_id": "pallet-eu",
          "instance": 1,
          "label": "Euro pallet",
          "x": 0,
          "y": 0,
          "z": 0,
          "length": 80,
          "width": 120,
          "height": 140,
          "rotated": true,
          "orientation": "wlh",
          "step": 1,
          "weight": 450
        },
        {
          "item_id": "pallet-eu",
          "instance": 2,
          "label": "Euro pallet",
          "x": 0,
          "y": 0,
          "z": 120,
          "length": 80,
          "width": 120,
          "height": 140,
          "rotated": true,
          "orientation": "wlh",
          "step": 2,
          "weight": 450
        },
        {
          "item_id": "carton-a",
          "instance": 1,
          "label": "Carton A",
          "x": 720,
          "y": 0,
          "z": 0,
          "length": 60,
          "width": 40,
          "height": 40,
          "rotated": false,
          "orientation": "lwh",
          "step": 19,
          "weight": 12
        }
      ]
    }
  ],
  "unplaced": [],
  "warnings": [],
  "pdf_url": "https://app.cargoduo.com/r/Xq7Lm2Vt9KbR4cN8wZp1Hs6Yd3Fg5Jk0Ta2Ue7Wn4Ci",
  "expires_at": "2026-11-02T09:12:03Z"
}

Kısaltılmıştır: 58 yerleşimden 3'ü gösteriliyor.

Yanıtlar

200OKYükleme planı.Result
AdTürZorunluAçıklama
job_idstring
string
Hayır
İş.
vehiclesResultVehicle[]
ResultVehicle[]
Hayır
Yükleme sırasına göre yüklenen araçlar (boş araçlar dahil edilmez).
unplacedUnplacedItem[]
UnplacedItem[]
Hayır
Yerleştirilemeyen adetler ve nedenleri.
warningsWarning[]
Warning[]
Hayır
Planla ilgili uyarılar.
pdf_urlstring
string
Hayır
Planı PDF olarak oluşturan tarayıcı bağlantısı.
expires_atstring
string
Hayır
Bu sonucun silineceği zaman (RFC 3339).
401Unauthorizedunauthorizedkey_revokedkey_expiredError
- 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_missingError
- 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 foundjob_not_foundError
- job_not_foundOrganizasyonunuzda bu ID'ye sahip bir iş yok.
AdTürZorunluAçıklama
errorErrorBodyzorunlu
ErrorBody
Evet
Tüm hata kodları
409Conflictjob_not_finishedjob_failedjob_canceledError
- job_not_finishedİş hâlâ sırada ya da çalışıyor.
- job_failedİş başarısız oldu; sonucu yok.
- job_canceledİş iptal edildi; sonucu yok.
AdTürZorunluAçıklama
errorErrorBodyzorunlu
ErrorBody
Evet
Tüm hata kodları
410Goneresult_expiredError
- result_expiredSonucun saklama süresi doldu ve sonuç silindi.
AdTürZorunluAçıklama
errorErrorBodyzorunlu
ErrorBody
Evet
Tüm hata kodları
429Too many requestsrate_limitedError
- 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_errorError
- internal_errorBizim tarafımızda bir hata oluştu.
AdTürZorunluAçıklama
errorErrorBodyzorunlu
ErrorBody
Evet
Tüm hata kodları
503Service unavailableapi_disabledError
- 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ı

Sonuçlar ve koordinatlarHer öğenin konumu, yönelimi ve yükleme sırası.PDF raporlarıYükleme planının PDF'ini oluşturan, paylaşılabilir bir bağlantı.GETİşi getirBir işin durumu, ilerlemesi, özeti ve maliyeti.

Kimlik doğrulama

Yol parametreleri

Örnek istek

Örnek yanıt

Yanıtlar

İlgili