Интерфейсы управления балансом аккаунта
-
GET v1.0/Balance/Get?Api={Api}&Timestamp={Timestamp}&Sig={Sig}
Получение текущего баланса аккаунта владельца интерфейса
Параметры
- Api (Int32): Идентификатор API-интерфейса.
- Timestamp (String): Время формирования запроса по UTC в формате YYYY-MM-dd HH:mm:ss.
- Sig (String): Подпись запроса, образованная путем вычисления MD5-хэша от результата склеивания через два двоеточия параметров Api, Timestamp, Key и остальных, отсортированных в алфавитном порядке обязательных параметров.
Формирование подписи
md5(Api::Timestamp::Key)
Результат
Объект ApiResult, содержащий результат выполнения запроса, или объект Error, в случае ошибки.-
Message (String): Примечание к ответу на запрос.
-
Data (BalanceModel): Данные, содержащие результат выполения запроса.
- Money (String): Остаток монет на балансе аккаунта.
- Credits (String): Остаток кредитов на балансе аккаунта.
Примеры
Api=0&Timestamp=2011-05-25+12:34:56&Sig=8c629fcbdd886a340bef01e8fc92273b
{"Message":"message","Data":{"Money":"0","Credits":"0"}}
<?xml version="1.0" encoding="utf-8"?> <ApiResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="api"> <Message>message</Message> <Data> <Credits>0</Credits> <Money>0</Money> </Data> </ApiResult>
-
POST v1.0/Balance/Transfer
Перевод средств на баланс аккаунта другого пользователя системы
Параметры
- Payee (Int32): Идентификатор (id аккаунта) получателя средств.
- Payer (Int32): Идентификатор (id аккаунта) отправителя средств.
- Amount (Decimal): Сумма перевода (не менее 0.01).
- Currency (BalanceCurrency): Валюта перевода (Money или Credits).
- Note (String): Примечание к платежу (до 60 символов).
- Api (Int32): Идентификатор API-интерфейса.
- Timestamp (String): Время формирования запроса по UTC в формате YYYY-MM-dd HH:mm:ss.
- Sig (String): Подпись запроса, образованная путем вычисления MD5-хэша от результата склеивания через два двоеточия параметров Api, Timestamp, Key и остальных, отсортированных в алфавитном порядке обязательных параметров.
Формирование подписи
md5(Api::Timestamp::Key::Amount::Currency::Note::Payee::Payer)
Результат
Объект ApiResult, содержащий результат выполнения запроса, или объект Error, в случае ошибки.-
Message (String): Примечание к ответу на запрос.
-
Data (BalanceTransferModel): Данные, содержащие результат выполения запроса.
- TransactionId (Int64): Идентификатор транзакции, в результате которой был выполнен перевод средств.
- Money (String): Остаток монет на балансе аккаунта.
- Credits (String): Остаток кредитов на балансе аккаунта.
Примеры
Api=0&Timestamp=2011-05-25+12:34:56&Payer=0&Payee=1&Amount=100&Currency=Credits&Note=payment+note&Sig=8c629fcbdd886a340bef01e8fc92273b
{"Message":"message","Data":{"TransactionId":0,"Money":"0","Credits":"0"}}
<?xml version="1.0" encoding="utf-8"?> <ApiResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="api"> <Message>message</Message> <Data> <Credits>0</Credits> <Money>0</Money> <TransactionId>0</TransactionId> </Data> </ApiResult>