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

Подготовка

  1. Войдите на платформу AceDataCloud。
  2. Создайте токен аккаунта в консоли Account Token и сразу сохраните его в менеджере паролей или Secret Manager。
  3. При необходимости получите ID для фильтрации из списка заявок на сервис、списка учётных данных API или списка API。
Полное описание токенов см. в разделе управление токенами аккаунта。Токен аккаунта и Credential для вызова бизнес-API нельзя использовать взаимозаменяемо。

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

Этот интерфейс синхронно возвращает CSV в потоковом режиме, не создаёт задачу экспорта и не возвращает JSON или ссылку для скачивания. Только если не указаны обе даты — начала и конца, по умолчанию экспортируются записи от начала текущего календарного месяца до текущего момента; если указана только одна граница, другая граница не будет автоматически дополнена границей текущего месяца。

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

Диапазон экспорта всегда ограничен записями, доступными текущему аккаунту как плательщику и/или фактическому вызывающему лицу; экспорт между аккаунтами не поддерживается。

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

Непосредственно сохранить CSV за текущий месяц:
Экспорт по Application, времени и коду состояния:
Потоковое сохранение и проверка целостности в Python:

Столбцы CSV

Порядок заголовков CSV фиксирован:
Единица объёма определяется service.unit соответствующего Application。

Как определить, завершён ли экспорт полностью

За один раз может быть выведено не более 1 000 000 записей. После того как сервер начал возвращать CSV, он не может изменить промежуточную ошибку на другой HTTP-статус, поэтому клиент должен проверить последнюю строку:
  • # truncated::достигнут лимит количества строк; экспортируйте частями с меньшими временными окнами。
  • # error::потоковое чтение прервано; уменьшите диапазон и экспортируйте повторно。
При обнаружении любого marker программа сверки должна считать файл неполным и не может молча проводить его в учёте。

Ошибки и повторные попытки

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