Перейти к основному содержанию
Сводка количества запросов и фактически списанных единиц по датам и API для текущей учётной записи, подходит для подготовки ежемесячных отчётов, графиков тенденций и анализа затрат. Если требуется устранять ошибки по каждой записи, используйте список записей вызовов; если требуются полные офлайн-детали, используйте экспорт объёма вызовов. Диапазон запросов для записей вызовов и сводок по тарификации составляет последние 60 дней; тела запросов и ответов отдельно хранятся последние 30 дней. Истечение срока хранения тела не изменяет фактическое списание, объём использования или агрегированную статистику этой записи.

Подготовка

  1. Войдите на платформу AceDataCloud.
  2. Создайте токен учётной записи в консоли Account Token и сразу сохраните его.
  3. Если нужно сузить область, получите соответствующий ID из списка заявок на сервисы, списка учётных данных API или списка API.
Полное описание токенов см. в разделе управление токенами учётной записи. Этот интерфейс использует Account Token, а не бизнес-учётные данные Credential.

Обзор интерфейса

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

start_time / end_time всё ещё можно использовать как совместимые псевдонимы для старых клиентов; для новых интеграций единообразно используйте created_at_from / created_at_to. created_at_to в формате даты включает этот календарный день, то есть в качестве границы используется полночь следующего дня.

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

Запросить ежедневную/API-сводку за текущий месяц по пекинскому времени с добавлением измерения моделей:
Запросить объём использования за неделю для указанного Application:
Пример Python:

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

Поля ответа

Единица измерения квоты зависит от service.unit соответствующего Application. Если запрос включает сервисы с разными единицами измерения, сначала выполните отдельную статистику по service_id или application_id, чтобы избежать прямого сравнения или сложения. Если время окончания не больше времени начала, интерфейс возвращает полную пустую структуру: items=[], total=0, apis={}, requests=0, models=[].

Рекомендации по ошибкам и производительности

  • По умолчанию не включайте include_models; активируйте его только если отчёту действительно требуется разбивка по моделям.
  • Для запросов большого диапазона приоритетно разделяйте данные по service_id или application_id: это позволяет избежать смешивания единиц измерения и снизить стоимость запроса.
  • Даты без вызовов не заполняются нулями автоматически; перед построением графика клиент должен дополнить ось дат.

Следующие шаги