Skip to main content
Сводка количества запросов и фактически списанных лимитов текущего аккаунта по датам и API, подходит для создания ежемесячных отчетов, графиков трендов и анализа затрат. Для построчного поиска ошибок используйте список записей вызовов, для полных офлайн-деталей используйте экспорт объема вызовов。

Подготовка

  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, это одновременно предотвращает смешивание единиц и снижает стоимость запроса。
  • Даты без вызовов не дополняются нулями автоматически, перед построением графика клиент должен дополнить ось дат。

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