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

Xem mức sử dụng

Yêu cầu, tác vụ, credit, giây tính toán và số xe theo từng ngày (UTC).

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

Không có from/to: 30 ngày gần nhất. Tối đa 92 ngày mỗi lần gọi.

Xác thực

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

Tham số truy vấn

TênKiểuBắt buộcMô tả
fromstring
string
Không

Ngày đầu, YYYY-MM-DD (UTC).

tostring
string
Không

Ngày cuối, YYYY-MM-DD (UTC). Mặc định là hôm nay.

Yêu cầu mẫu

curl -X GET "https://runner.cargoduo.com/v1/usage?from=2026-10-17&to=2026-10-19" \
  -H "Authorization: Bearer $CARGODUO_API_KEY"

Phản hồi mẫu

200 OK · Usage
{
  "data": [
    {
      "date": "2026-10-17",
      "requests": 41,
      "jobs": 9,
      "credits": 2.931,
      "compute_seconds": 38.2,
      "vehicles": 11
    },
    {
      "date": "2026-10-18",
      "requests": 12,
      "jobs": 3,
      "credits": 0.829,
      "compute_seconds": 9.8,
      "vehicles": 3
    },
    {
      "date": "2026-10-19",
      "requests": 27,
      "jobs": 6,
      "credits": 1.867,
      "compute_seconds": 21.4,
      "vehicles": 7
    }
  ]
}

Phản hồi

  • 200OKMỗi ngày một dòng.
    TênKiểuBắt buộcMô tả
    dataUsageDay[]
    UsageDay[]
    Không
  • 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