Підготовка
- Увійдіть до платформи AceDataCloud.
- Створіть токен облікового запису в консолі Account Token.
- Звичайні користувачі використовують
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.
Приклад запиту
Опис відповіді
Відповідь має вигляд{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.

