Bỏ qua đến nội dung
CargoDuo logoCargoDuo
Bảng giá
Tài liệu cho nhà phát triểnTham chiếu APITác vụ

Liệt kê tác vụ

Các tác vụ của tổ chức, mới nhất trước, trả về theo từng trang.

GEThttps://runner.cargoduo.com/v1/jobs

Xác thực

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

Tham số truy vấn

TênKiểuBắt buộcMô tả
limitinteger
integer
Không

Kích thước trang.

Mặc định 201–100
cursorstring
string
Không

next_cursor của trang trước.

statusstring
string
Không

Chỉ các tác vụ có trạng thái này.

queuedrunningsucceededfailedcanceled

Yêu cầu mẫu

curl -X GET "https://runner.cargoduo.com/v1/jobs?limit=2&status=succeeded" \
  -H "Authorization: Bearer $CARGODUO_API_KEY"

Phản hồi mẫu

200 OK · JobList
{
  "data": [
    {
      "id": "job_4bK9mT2xQe7LpW1zRc8VdN3f",
      "object": "job",
      "status": "succeeded",
      "reference": "order-1042",
      "source": "api",
      "created_at": "2026-10-19T09:12:03Z",
      "started_at": "2026-10-19T09:12:03Z",
      "finished_at": "2026-10-19T09:12:07Z",
      "progress": {
        "stage": "done",
        "vehicles_done": 1,
        "placed_items": 58
      },
      "summary": {
        "items_requested": 58,
        "items_placed": 58,
        "items_unplaced": 0,
        "vehicles_used": 1,
        "total_weight": 8580,
        "volume_utilization": 0.3116,
        "queue_ms": 12,
        "compute_ms": 4210
      },
      "cost": {
        "credits": 0.28105,
        "reserved_credits": 1.11,
        "rate_card_version": 1,
        "breakdown": {
          "base": 0.06,
          "vehicles": 0.2,
          "compute": 0.02105,
          "large_load": 0
        }
      },
      "error": null,
      "warnings": [],
      "result_url": "https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result",
      "pdf_url": "https://app.cargoduo.com/r/Xq7Lm2Vt9KbR4cN8wZp1Hs6Yd3Fg5Jk0Ta2Ue7Wn4Ci",
      "expires_at": "2026-11-02T09:12:03Z"
    },
    {
      "id": "job_7hN2wQ5rTb9xKc3LmP8sVa1d",
      "object": "job",
      "status": "succeeded",
      "reference": "order-1039",
      "source": "api",
      "created_at": "2026-10-18T07:12:03Z",
      "started_at": "2026-10-18T07:12:03Z",
      "finished_at": "2026-10-18T07:12:05Z",
      "progress": {
        "stage": "done",
        "vehicles_done": 1,
        "placed_items": 24
      },
      "summary": {
        "items_requested": 24,
        "items_placed": 24,
        "items_unplaced": 0,
        "vehicles_used": 1,
        "total_weight": 6240,
        "volume_utilization": 0.2213,
        "queue_ms": 9,
        "compute_ms": 2870
      },
      "cost": {
        "credits": 0.27435,
        "reserved_credits": 1.11,
        "rate_card_version": 1,
        "breakdown": {
          "base": 0.06,
          "vehicles": 0.2,
          "compute": 0.01435,
          "large_load": 0
        }
      },
      "error": null,
      "warnings": [],
      "result_url": "https://runner.cargoduo.com/v1/jobs/job_7hN2wQ5rTb9xKc3LmP8sVa1d/result",
      "pdf_url": "https://app.cargoduo.com/r/Xq7Lm2Vt9KbR4cN8wZp1Hs6Yd3Fg5Jk0Ta2Ue7Wn4Ci",
      "expires_at": "2026-11-01T07:12:03Z"
    }
  ],
  "next_cursor": "job_7hN2wQ5rTb9xKc3LmP8sVa1d"
}

Phản hồi

  • 200OKMột trang tác vụ.
    TênKiểuBắt buộcMô tả
    dataJob[]
    Job[]
    Không
    next_cursorstring
    string
    Không

    Truyền vào ?cursor= để lấy trang tiếp theo; rỗng ở trang cuối.

  • 401Unauthorizedunauthorizedkey_revokedkey_expired
    • 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_missing
    • 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
  • 422Unprocessable entityvalidation_failed
    • validation_failedYêu cầu là JSON đúng cú pháp nhưng mô tả một tác vụ không hợp lệ. details[] liệt kê mọi lỗi.
    TênKiểuBắt buộcMô tả
    errorErrorBodybắt buộc
    ErrorBody
    Có
    Tất cả mã lỗi
  • 429Too many requestsrate_limited
    • 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_error
    • 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_disabled
    • 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