Выполняет авторизацию в системе.
Использование этого метода всегда происходит в два этапа:
- На первом этапе требуется передать необходимые идентификационные данные (id ВКонтакте или логин и пароль)
В ответ на это вы получите задание для подтверждения, состоящее из id задания и другой необходимой информации (зависит от типа входа, подробнее в описании конкретного способа) - После выполнения задания нужно повторить запрос, добавив к нему полученный id и авторизация будет пройдена
После успешного выполнения сервер передаст идентификатор открытой для вас сессии в заголовке Set-Cookie, который нужно сохранить и передавать в заголовке Cookie при совершении запросов к API.
Поддержка протокола HTTP завершена, параграф ниже более не является актуальным.
По некоторым, независящим от нас, причинам сервис использует разные сессии для HTTP- и HTTPS-запросов.
При этом «обычная» сессия открывается сразу, а «безопасная» лишь после первого запроса по протоколу HTTPS.
Т.о. рекомендуется проходить авторизацию по протоколу HTTPS, чтобы сразу получить оба идентификатора.
В ответе обязательно содержится поле user_token, значение которого необходимо использовать для получения доступа к методам coupons.create, users.update и balance.transfer
Вход возможен несколькими способами.
Через отметку «Мне нравится»
Первичный вызов происходит с обязательным параметром authname, содержащим id ВКонтакте аккаунта, который вы хотите авторизовать
Значение может быть как с приставкой id, так и без нее.
Также принимается короткое имя страницы или даже ссылка на нее.
Например:
http://likest.ru/api/users.login?authname=id12345
В ответ на это сервер укажет страницу, на которой указанный вами аккаунт должен поставить отметку «Мне нравится»:
{
"status":"VALIDATION_LIKE",
"like_id":"70",
"like_like":"vk.com/wall-654321_542"
}
Чтобы продолжить, поставьте лайк на указанную в поле like_like запись, и, добавив в первоначальный запрос параметр like_id с указанным сервером значением, повторите вызов метода (между запросами должно пройти не более ста секунд).
Например:
http://likest.ru/api/users.login?authname=id12345&like_id=70
Авторизация будет пройдена:
{
"status":"SUCCESS",
"user_token":"Eyi95lSXC33nX4HG6PaH_Bl9gaf2WPAoc1Vwj_BaTBQ"
}
Через установку статуса ВКонтакте
Для использования этого способа входа, выполните запрос также как для авторизации через отметку «Мне нравится», добавив параметр validation=status
Например:
http://likest.ru/api/users.login?authname=id12345&validation=status
В остальном алгоритм полностью совпадает со входом через лайк, за исключением того, что вместо like_id и like_like сервер ответит status_id и status_status соответственно.
Например:
{
"status":"VALIDATION_STATUS",
"status_id":"234",
"status_status":"Не осуждайте меня за то, что и сами бы сделали с удовольствием"
}
После установки статуса status_status, включите в запрос status_id, повторите вызов (между вызовами не должно пройти более пяти минут), и вход будет выполнен.
По паролю (с CAPTCHA)
Первичный вызов происходит с обязательными параметрами name и pass, содержащими имя и пароль на likest аккаунта, который вы хотите авторизовать
Например:
http://likest.ru/api/users.login?name=123456&pass=qwerty
В ответ на это сервер попросит разгадать код с картинки:
{
"status":"VALIDATION_CAPTCHA",
"captcha_id":"12627245",
"captcha_captcha":"http://likest.ru/api/captcha.image?captcha_id=12627245"
}
Разгадав код, добавьте в запрос параметры captcha_id с переданным сервером значением и captcha_captcha с полученным кодом, а после повторите его.
Например:
http://likest.ru/api/users.login?name=123456&pass=qwerty&captcha_id=12627245&captcha_captcha=W62
Вход будет произведен:
{
"status":"SUCCESS",
"user_token":"Eyi95lSXC33nX4HG6PaH_Bl9gaf2WPAoc1Vwj_BaTBQ"
}
По паролю (за один запрос с цифровой подписью)
Данной способ доступен только для сертифицированных программ
Уникальные значения status
ERR_ALREADY_AUTHENTICATED
Вы выполняете запрос, будучи уже авторизованны в системе
ERR_INVALID_AUTHNAME
Некорректное значение параметра authname
ERR_VALIDATION_FAILED
Не удалось подтвердить выполнение запрошенного действия
ERR_VKDATA_NO_FIRST_NAME
В профиле ВКонтакте отсутствует имя
ERR_VKDATA_NO_LAST_NAME
В профиле ВКонтакте отсутствует фамилия
ERR_VKDATA_PROFILE_HIDDEN
Профиле ВКонтакте скрыт
ERR_SORRY_WE_ARE_OVERLOADED
Сервер слишком сильно нагружен (текущий лимит — 40.000 аккаунтов ВКонтакте)
Простите нас, но мы пока еще не можем авторизовать еще больше пользователей, хотя скоро это исправим.
ERR_WRONG_LIKE_ID
ERR_WRONG_STATUS_ID
ERR_WRONG_CAPTCHA_ID
Переданный вами параметр like_id (status_id или captcha_id) устарел, или никогда не существовал или был использован (успешно осуществлен вход)
ERR_WRONG_NAME_PASS
Неправильные имя и пароль
VALIDATION_LIKE
VALIDATION_STATUS
VALIDATION_CAPTCHA
Система запрашивает подтверждение путем установки отметки «Мне нравится», установки статуса или распознавания кода с изображения соответственно