Tài liệu cho nhà phát triểnTham chiếu APITác vụ

Xem kết quả tác vụ

Sơ đồ xếp hàng của một tác vụ đã thành công: mọi xe được dùng, mọi vị trí xếp, những gì không xếp vừa và liên kết PDF.

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

Xác thực

Khóa API dạng Bearer, phạm vi quyềnjobs:readTìm hiểu thêm

Tham số đường dẫn

TênKiểuBắt buộcMô tả

idstringbắt buộc

string

Có

ID tác vụ (job_…).

Yêu cầu mẫu

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

Phản hồi mẫu

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

Rút gọn: chỉ hiển thị 3 trong 58 vị trí xếp.

Phản hồi

200OKSơ đồ xếp hàng.Result
TênKiểuBắt buộcMô tả
job_idstring
string
Không
Tác vụ.
vehiclesResultVehicle[]
ResultVehicle[]
Không
Các xe đã xếp hàng theo thứ tự xếp (bỏ qua xe trống).
unplacedUnplacedItem[]
UnplacedItem[]
Không
Các kiện không xếp được, kèm lý do.
warningsWarning[]
Warning[]
Không
Ghi chú về sơ đồ.
pdf_urlstring
string
Không
Liên kết mở trên trình duyệt để tạo PDF của sơ đồ.
expires_atstring
string
Không
Thời điểm kết quả này bị xóa (RFC 3339).
401Unauthorizedunauthorizedkey_revokedkey_expiredError
- unauthorizedThiếu khóa API, khóa sai định dạng hoặc không xác định.
- key_revokedKhóa đã bị thu hồi.
- key_expiredKhóa đã quá ngày hết hạn.
TênKiểuBắt buộcMô tả
errorErrorBodybắt buộc
ErrorBody
Có
Tất cả mã lỗi
403Forbiddenip_not_allowedsubscription_inactiveaccount_inactivescope_missingError
- ip_not_allowedIP gọi đến không nằm trong danh sách IP được phép của khóa.
- subscription_inactiveTổ chức không có gói đăng ký đang hoạt động nào bao gồm API.
- account_inactiveTổ chức bị tạm ngưng, hoặc không có chủ sở hữu nào có tài khoản đang hoạt động.
- scope_missingKhóa thiếu phạm vi quyền mà endpoint này yêu cầu.
TênKiểuBắt buộcMô tả
errorErrorBodybắt buộc
ErrorBody
Có
Tất cả mã lỗi
404Not foundjob_not_foundError
- job_not_foundTổ chức của bạn không có tác vụ nào với ID này.
TênKiểuBắt buộcMô tả
errorErrorBodybắt buộc
ErrorBody
Có
Tất cả mã lỗi
409Conflictjob_not_finishedjob_failedjob_canceledError
- job_not_finishedTác vụ vẫn đang chờ hoặc đang chạy.
- job_failedTác vụ thất bại; không có kết quả.
- job_canceledTác vụ đã bị hủy; không có kết quả.
TênKiểuBắt buộcMô tả
errorErrorBodybắt buộc
ErrorBody
Có
Tất cả mã lỗi
410Goneresult_expiredError
- result_expiredKết quả đã quá thời gian lưu trữ và đã bị xóa.
TênKiểuBắt buộcMô tả
errorErrorBodybắt buộc
ErrorBody
Có
Tất cả mã lỗi
429Too many requestsrate_limitedError
- rate_limitedQuá nhiều yêu cầu trong phút, giờ hoặc ngày hiện tại (theo khóa hoặc theo tổ chức), hoặc có hơn 60 lần xác thực thất bại mỗi phút từ địa chỉ IP của bạn.
TênKiểuBắt buộcMô tả
errorErrorBodybắt buộc
ErrorBody
Có
Tất cả mã lỗi
500Internal server errorinternal_errorError
- internal_errorĐã xảy ra lỗi ở phía chúng tôi.
TênKiểuBắt buộcMô tả
errorErrorBodybắt buộc
ErrorBody
Có
Tất cả mã lỗi
503Service unavailableapi_disabledError
- api_disabledAPI tạm thời bị tắt (bảo trì) hoặc đã bị tắt cho tổ chức.
TênKiểuBắt buộcMô tả
errorErrorBodybắt buộc
ErrorBody
Có
Tất cả mã lỗi

Kết quả và tọa độMỗi kiện hàng nằm ở đâu, theo hướng nào và theo thứ tự xếp nào.Báo cáo PDFLiên kết chia sẻ được, dùng để tạo PDF sơ đồ xếp hàng.GETXem tác vụTrạng thái, tiến độ, tóm tắt và chi phí của một tác vụ.

Xác thực

Tham số đường dẫn

Yêu cầu mẫu

Phản hồi mẫu

Phản hồi

Liên quan