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 giới hạn

Các giới hạn áp dụng cho tổ chức của bạn và bảng giá dùng để tính giá tác vụ mới.

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

Xác thực

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

Yêu cầu mẫu

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

Phản hồi mẫu

200 OK · Limits
{
  "max_items_per_request": 2000,
  "max_vehicles_per_request": 20,
  "max_time_limit_seconds": 90,
  "allowed_vehicle_types": [
    "truck",
    "trailer",
    "container",
    "pallet"
  ],
  "concurrency": 1,
  "max_queued_jobs": 20,
  "rate_limits": {
    "per_minute": 60,
    "per_hour": 1000,
    "per_day": 5000
  },
  "retention_days": 14,
  "rate_card": {
    "version": 1,
    "per_job": 0.06,
    "per_vehicle": 0.2,
    "per_compute_second": 0.005,
    "large_load_threshold": 500,
    "per_hundred_items_over": 0.02
  }
}

Phản hồi

  • 200OKGiới hạn và bảng giá.
    TênKiểuBắt buộcMô tả
    max_items_per_requestinteger
    integer
    Không

    Số kiện tối đa (tổng số lượng) mỗi tác vụ.

    max_vehicles_per_requestinteger
    integer
    Không

    Số xe tối đa một tác vụ có thể khai báo và xếp (kể cả xe được tự động thêm).

    max_time_limit_secondsinteger
    integer
    Không

    Thời gian tính toán tối đa mỗi tác vụ.

    allowed_vehicle_typesstring[]
    string[]
    Không

    Các loại xe API chấp nhận.

    concurrencyinteger
    integer
    Không

    Số tác vụ của tổ chức được tính toán cùng lúc; các tác vụ khác chờ trong hàng đợi.

    max_queued_jobsinteger
    integer
    Không

    Số tác vụ đang chờ + đang chạy mỗi tổ chức.

    rate_limitsRateLimits
    RateLimits
    Không

    Số yêu cầu mỗi khung thời gian, theo khóa và theo tổ chức.

    retention_daysinteger
    integer
    Không

    Số ngày lưu nội dung yêu cầu/kết quả và liên kết PDF.

    rate_cardRateCard
    RateCard
    Không

    Giá tính bằng credit (1 credit = 1 USD).

  • 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
  • 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