Перейти до основного вмісту
Повертає посторінково Application, якими володіє обліковий запис або на використання яких він має дозвіл, включно з балансом, статусом, зведенням послуг і пов’язаними обліковими даними. Підходить для пакетного моніторингу балансу, пошуку Application ID та переходу до керування обліковими даними.

Підготовка

  1. Увійдіть до платформи AceDataCloud.
  2. Створіть токен облікового запису в консолі Account Token.
  3. Звичайні користувачі використовують user_id=me; також можна отримати власний UUID через GET /api/v1/platform-tokens/me/.

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

Звичайні користувачі повинні передавати user_id=me. Якщо його не передати, запит спочатку не буде звужений за обліковим записом, і під час пагінації при зустрічі з об’єктами без прав доступу може повертатися 403; адміністратори без його передавання можуть переглядати всю таблицю.

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

paid, disabled, expired, low_balance і tag наразі не є параметрами серверної фільтрації. Для сповіщень про баланс слід після отримання списку визначати на клієнті на основі remaining_amount, service.unit і бізнес-порогів кожного Application.

Приклад запиту

Одночасний перегляд Application, якими ви володієте, і тих, які інші авторизували для вас:

Опис відповіді

Відповідь має вигляд {count, items}. Кожен елемент містить поля моделі Application, а також:
  • service: id, alias, title, type, unit, icon_url;
  • credentials: зведення облікових даних, які поточний викликач має право бачити;
  • paid, remaining_amount, used_amount, disabled, allow_consume_global, allow_overdraft;
  • фактичне значення scope — Individual або Global;
  • фактичне значення type — Usage або Period.
allow_overdraft — це кероване адміністратором булеве поле лише для читання, за замовчуванням false. Для застосунків із оплатою за використання (Usage), у яких увімкнено овердрафт, недостатній баланс не перешкоджає викликам, а плата все одно стягується відповідно до фактичного використання; від’ємний баланс означає суму, що очікує розрахунку. Вимкнення, завершення строку дії та ліміти API-облікових даних усе ще діють. remaining_amount може бути порожнім; клієнт повинен спочатку перевірити його на порожнє значення, а потім виконувати числове порівняння. Одиниця квоти визначається через service.unit.

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