== Интерфейс запроса баланса. ==
Интерфейс позволяет запросить баланс по всем личным счетам в системе, в том числе, и по отключенным. Подробнее о счетах в системе см. [[ОписаниеСистемы/ЛичныеСчета|описание личных счетов в системе]].
=== Параметры запроса ===
Для запроса баланса необходимо выполнить POST запрос на url https://api.masspayer.ru/api/v2/get_balance, который содержит только авторизационные данные. Принцип формирования авторизационных данных описан [[api/v2/ДанныеАвторизации|здесь]]. Дополнительно, запрос может быть [[../ПодписьЗапроса|подписан]].
=== Параметры ответа ===
'''Формат:'''{{{#!highlight xml
...
}}}
'''Описание параметров:'''
||'''Название'''||'''Описание'''||'''Примечание'''||
||bills \ ''bill''||Личный счет в системе||''Атрибут {{{id}}}:''<
>указывает внутренний id счета в системе<
>''Атрибут {{{disabled}}}:''<
>равен {{{0}}}, если счет не закрыт и {{{1}}}, если счет в системе закрыт||
||bills \ bill \ ''name''||Наименование счёта в система||Удобное имя, которое было выбрано при создании счета||
||bills \ bill \ ''amount''||Баланс счета на момент запроса||Сумма указывается в валюте счета||
||bills \ bill \ ''currency''||Валюта счета||Содержит буквенный код валюты счета (см. [[ОписаниеСистемы/Валюты|описание валют системы]]).<
>''Атрибут {{{id}}}:''<
>указывает внутренний id валюты в системе.||
Прочие параметры ответа описаны в документе [[api/v2/ОбщиеПараметрыОтвета|"Общие параметры ответа"]].
==== Пример ====
Пример запроса баланса для пользователя с:
* логином ''3'',
* паролем ''12345678'',
* ключом API ''secret_api_key''.
'''Запрос:'''{{{#!highlight xml
2014-10-14T06:48:24.891157+04:00
3
$2a$10$1SHTg8UanwjBV9qWfXLLEuilweNq26/C2PUZi4A.cCfrCL9Y0sBgG
$2a$10$e6kSO/7Y/1McnvjQwmiPe.aBn9T1/4rrj0qP6wBE7MKbdtUEgA68K
}}}
'''Ответ:'''{{{#!highlight xml
2014-10-14T06:48:25.302751+04:00
0
Ошибки нет
$2a$10$8F7HhaVJvM4FveDfmIPVf.5i6JySy1mVADdUL6YZ/Zs.d.cVuK8RO
Рублевый
456.0
RUR
Доллары
556.0
USD
WMR основной
563.0
WMR
WMZ
125.0
WMZ
}}}
----
КатегорияApiV2