跳到主要内容
开发者文档API 参考账户

查询上限

适用于您组织的各项上限,以及新任务计价所用的价目表。

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

认证

Bearer API 密钥 · 所需权限范围account:read了解更多

请求示例

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

响应示例

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

响应

  • 200OK上限和价目表。
    名称类型必填说明
    max_items_per_requestinteger
    integer
    否

    每个任务的最大物品件数(所有数量之和)。

    max_vehicles_per_requestinteger
    integer
    否

    每个任务可列出和装载的最大车辆数(含自动添加的车辆)。

    max_time_limit_secondsinteger
    integer
    否

    每个任务的计算时间预算上限。

    allowed_vehicle_typesstring[]
    string[]
    否

    API 接受的车辆类型。

    concurrencyinteger
    integer
    否

    您组织可同时计算的任务数;超出的任务在队列中等待。

    max_queued_jobsinteger
    integer
    否

    每个组织的排队中 + 运行中任务数上限。

    rate_limitsRateLimits
    RateLimits
    否

    每个时间窗口的请求数,按密钥和按组织分别计算。

    retention_daysinteger
    integer
    否

    请求体/结果体和 PDF 链接的保留天数。

    rate_cardRateCard
    RateCard
    否

    以积分计的价格(1 积分 = 1 USD)。

  • 401Unauthorizedunauthorizedkey_revokedkey_expired
    • unauthorizedAPI 密钥缺失、格式错误或无法识别。
    • key_revoked密钥已被撤销。
    • key_expired密钥已过期。
    名称类型必填说明
    errorErrorBody必填
    ErrorBody
    是
    全部错误码
  • 403Forbiddenip_not_allowedsubscription_inactiveaccount_inactivescope_missing
    • ip_not_allowed调用方 IP 不在该密钥的 IP 白名单中。
    • subscription_inactive组织没有包含 API 的有效订阅。
    • account_inactive组织已被暂停使用,或其所有者的账户均未处于有效状态。
    • scope_missing密钥缺少此接口所需的权限范围。
    名称类型必填说明
    errorErrorBody必填
    ErrorBody
    是
    全部错误码
  • 429Too many requestsrate_limited
    • rate_limited当前分钟、小时或天内的请求过多(按密钥或按组织计),或您的 IP 地址每分钟认证失败超过 60 次。
    名称类型必填说明
    errorErrorBody必填
    ErrorBody
    是
    全部错误码
  • 500Internal server errorinternal_error
    • internal_error服务端发生内部错误。
    名称类型必填说明
    errorErrorBody必填
    ErrorBody
    是
    全部错误码
  • 503Service unavailableapi_disabled
    • api_disabledAPI 暂时停用(维护中),或已对该组织关闭。
    名称类型必填说明
    errorErrorBody必填
    ErrorBody
    是
    全部错误码