Перейти до основного вмісту
Завантажте деталі викликів API поточного облікового запису безпосередньо у CSV, що підходить для фінансової звірки, офлайн-аналізу або збереження великої кількості записів. Якщо потрібно переглянути лише невелику кількість деталей на сторінці, спочатку скористайтеся списком записів викликів. Діапазон запиту для записів викликів і підсумків нарахувань становить останні 60 днів; тіла запитів і відповідей окремо зберігаються протягом останніх 30 днів. Закінчення терміну зберігання тіла не змінює фактичне списання, використання або зведену статистику цього запису.

Підготовка

  1. Увійдіть до платформи AceDataCloud.
  2. Створіть токен облікового запису в консолі Account Token і негайно збережіть його в менеджері паролів або Secret Manager.
  3. За потреби отримайте ID для фільтрації зі списку заявок на послуги, списку облікових даних API або списку API.
Повний опис токенів дивіться в керуванні токенами облікового запису. Токен облікового запису та Credential для виклику бізнес-API не можна використовувати взаємозамінно.

Огляд інтерфейсу

Цей інтерфейс синхронно потоково повертає CSV, не створює завдання експорту та не повертає JSON або посилання для завантаження. Лише коли не надано ані початкового, ані кінцевого часу, за замовчуванням експортуються записи від початку поточного календарного місяця до поточного моменту; якщо надано лише одну межу, інша сторона не буде автоматично доповнена межею поточного місяця.

Параметри запиту

Діапазон експорту завжди обмежений записами, видимими для поточного облікового запису як платника та/або фактичного викликачa, експорт між обліковими записами не підтримується.

Приклади запитів

Безпосередньо зберегти CSV за поточний місяць:
Експорт за Application, часом і кодом статусу:
Потокове збереження в Python і перевірка цілісності:

Стовпці CSV

Порядок заголовків CSV фіксований:
Одиниця обсягу визначається service.unit відповідного Application.

Як визначити, чи експорт завершено

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

Помилки та повторні спроби

Наступний крок