Перейти к содержимому
CargoDuo logoCargoDuo
Цены
Документация для разработчиковСправочник APIАккаунт

Получить статистику использования

Запросы, задания, кредиты, секунды вычислений и транспортные средства по дням (UTC).

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

Без from/to — последние 30 дней. Не более 92 дн. за один вызов.

Аутентификация

Bearer-ключ API с правомaccount:readПодробнее

Параметры запроса

ИмяТипОбязательноОписание
fromstring
string
Нет

Первый день, YYYY-MM-DD (UTC).

tostring
string
Нет

Последний день, YYYY-MM-DD (UTC). По умолчанию — сегодня.

Пример запроса

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

Пример ответа

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

Ответы

  • 200OKОдна строка на день.
    ИмяТипОбязательноОписание
    dataUsageDay[]
    UsageDay[]
    Нет
  • 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
    Да
    Все коды ошибок
  • 422Unprocessable entityvalidation_failed
    • validation_failedЗапрос — корректный JSON, но описывает недопустимое задание. В details[] перечислены все проблемы.
    ИмяТипОбязательноОписание
    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
    Да
    Все коды ошибок