Перед тем как отправить какой-либо запрос необходимо получить авторизационный SessionToken. Он может быть как пожизненный, так и сроком действия на 1 сутки.
Разрабатывайте приложения таким образом, чтобы никому из клиентов никогда не передавался Ваш SessionToken. Он должен быть известен только серверной части Вашего приложения и никогда клиентской.
SessionToken действителен до времени своей экспирации, если не будет изменен логин или пароль аккаунта – в таком случае все выданные ранее SessionToken перестают действовать.
Адрес: https://vps.house/api/logon/
username – Ваш email
password – пароль от Вашего аккаунта
endless – значение 1 для получения бессрочного токена и 0 для получения на 1 сутки
{
"rejectReason": 0,
"sessionToken": "eba97b4453daeb6e375983facd351ec3c8539faf85eb94a03114b942776c5381",
"expire": "19032016164537"
}
rejectReason – числовое значение (код ошибки)
errMessage – текстовое описание ошибки если возникла
sessionToken – авторизационный токен для дальнейшей работы
expire – дата и время (UTC) истечения срока действия токена, если NULL, то бессрочный (формат ddMMyyyyHHmmss)
0 – запрос выполнен успешно
1 – не указан логин/email
2 – не указан пароль
3 – неверная связка логин+пароль
5 – внутренняя ошибка системы
6 – не указан ключ API
7 – неверный ключ API
8 – превышено количество попыток входа. С данным кодом ошибки в ответном сообщении будет добавлен параметр accessDT, содержащий время UTC (ddMMyyyyHHmmss) когда будет возможно отправить повторный запрос авторизации для данного аккаунта.