Перейти к содержимому
CargoDuo logoCargoDuo
Цены
Документация для разработчиковСправочник 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_allowedIP-адреса вызывающей стороны нет в списке разрешённых IP для этого ключа.
    • subscription_inactiveУ организации нет активной подписки, включающей API.
    • account_inactiveРабота организации приостановлена, или у неё нет владельца с активной учётной записью.
    • scope_missingУ ключа нет области доступа, необходимой для этого endpoint.
    ИмяТипОбязательноОписание
    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
    Да
    Все коды ошибок