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

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

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

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

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

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

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

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

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

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

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

<a id="get-v1.0-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
{
  "balance": 0.5,
  "contactId": 0,
  "departmentId": 0,
  "firmId": 0,
  "isCommonWallet": false,
  "operationsForbidden": false,
  "walletId": 0
}
```

**Описание полей ответа**
- `balance` — Текущий баланс кошелька.
- `contactId` — Идентификатор контакта
- `departmentId` — Идентификатор подразделения
- `firmId` — Идентификатор фирмы
- `isCommonWallet` — Флаг общего кошелька
- `operationsForbidden` — Операции с кошельком запрещены пользователю.
- `walletId` — Идентификатор кошелька.

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

```json
{
  "error": "string",
  "reason": "string"
}
```