# API для работы с Биллингом

## Используемые термины

**Биллинг** - бизнес-процессы, связанные с приобретением услуг и работой с вирутальным счётом фирмы.

**Контакт** - рабочий профиль сотрудника, в котором указаны телефон, email, должность. У фирмы может быть несколько контактов.

**Баланс** - количество атисов у пользователя.

## Возможности API

С помощью API Биллинг участник ATI.SU может получить информацию, содержащую:

- [данные о балансе контакта](#методы-для-работы-с-биллингом)

## Методы для работы с Биллингом

### Баланс контакта

#### Получение текущего баланса контакта (если есть личный кошелек - баланс личного кошелька, если нет - общего)

<a id="get-v1.0-billing-virtual-accounts-balance"></a>

Получает текущий баланс контакта.

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.0/balance' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/billing.openapi.json)

**Пример ответа (200)**

```json
0.5
```

**Пример ответа (400)**

```json
{
  "error": "invalid_input_data",
  "reason": "Неверные входные данные."
}
```

**Описание полей ответа**
- `error` — Код ошибки
- `reason` — Описание ошибки
---

## llms.txt

Индекс ключевых страниц документации для LLM и AI-агентов доступен в [основном llms.txt](https://ati.su/developers/llms.txt).