Осуществляет передачу баланса или его части другому участнику Likest.
Ссылка на аккаунт ВКонтакте отправителя будет видна получателю перевода (но не наоборот).
Параметры
amount
Количество сердец, которые необходимо передать.
При amount=all передаются все имеющиеся сердца.
Обязательный параметр, целое положительное число или строка "all".
user_token
Токен пользователя, выданный при авторизции через API
Обязательный параметр.
recipient_lkuid
Id получателя на Likest.
Целое положительное число.
recipient_vkuid
Id получателя ВКонтакте.
Целое положительное число.
В запросе должен быть указан по-крайней мере один из вышеперечисленных идентификаторов получателя.
В случае, если указаны оба, система обработает только recipient_lkuid
Пример запроса (передача ста сердец аккаунту vk.com/idXXXX):
https://likest.ru/api/balance.transfer?amount=100&recipient_vkuid=XXXX&user_token=Eyi95l...
Ответ:
{
"status":"SUCCESS",
"transfered":97
"comm":3
}
Поля transfered и comm ответа указывают на количество переданных сердец и на комиссию сервиса соответственно.
Уникальные значения status
ERR_WRONG_RECIPIENT
Вами указан несуществующий или заблокированный получатель перевода.
Также эта ошибка возникнет при попытке перевода самому себе.
ERR_AMOUNT_LT_X
Вы пытаетесь передать сердец меньше минимально возможного количества
В этом коде X на конце указывает минимальную сумму передачи
ERR_BALANCE
Не хватает сердец на балансе