> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Настройка глобального совместного использования баланса AceDataCloud Application

> Platform API guide - Ace Data Cloud

Настройте `allow_consume_global`. После включения соответствующие критериям Application с оплатой по факту использования смогут продолжать использовать глобальный баланс аккаунта при недостаточном собственном балансе.

## Подготовка

* Создайте и безопасно сохраните [Account Token](https://platform.acedata.cloud/documents/platform-token).
* Получите принадлежащий вам `application_id` из [списка заявок на сервис](https://platform.acedata.cloud/documents/platform-application-list).

```shell theme={null}
export PLATFORM_TOKEN='ваш токен аккаунта'
export APPLICATION_ID='ваш Application ID'
```

## Обзор API

| Пункт | Содержание |
| - | - |
| Метод | `POST` |
| URL | `https://platform.acedata.cloud/api/v1/applications/{application_id}/update-allow-consume-global/` |
| Авторизация | Account Token |
| Body | JSON |

```shell theme={null}
curl -X POST \
  "https://platform.acedata.cloud/api/v1/applications/${APPLICATION_ID}/update-allow-consume-global/" \
  -H "Authorization: Bearer ${PLATFORM_TOKEN}" \
  -H 'Content-Type: application/json' \
  -d '{"allow_consume_global": true}'
```

При успехе возвращается обновлённый объект Application. Ориентируйтесь на `allow_consume_global` в ответе, а не предполагайте, что значение запроса обязательно было сохранено.

> Application типа `Period` не разрешается расходовать глобальный баланс. Даже при запросе `true` сервер сохранит значение этого поля как `false`.

## Обработка ошибок

* `401`: Account Token недействителен или отсутствует.
* `403`: текущий аккаунт не является владельцем данного Application.
* `404`: Application ID не существует.

Вход для пополнения глобального баланса и доступные тарифы определяются консолью платформы и фактическими тарифами, возвращаемыми при [создании заказа](https://platform.acedata.cloud/documents/platform-order-create); не предполагайте наличие тарифа типа `Wallet`.

## Связанные API

* [Получить сведения об Application](https://platform.acedata.cloud/documents/platform-application-detail)
* [Получить список Application](https://platform.acedata.cloud/documents/platform-application-list)
* [Создать заказ на пополнение](https://platform.acedata.cloud/documents/platform-order-create)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.