Запрос создает нового пользователя на ЛитРес. Если указан e-mail, то пользователю по умолчанию отправляется приветственное письмо с логином и паролем и специальными предложениями для новых пользователей.
Если поле mail не заполнено, но login по формату соответствует e-mail, логин пользователя автоматически используется в профиле в качестве e-mail.
Если mail указан, а login нет, в качестве логина используется e-mail.
После успешного выполнения этого запроса выполняется автоматическая авторизация и дальнейшие запросы будут выполняться в контексте вновь созданного пользователя (с использованием актуального SID'а, полученного в ответе).
ID функции
w_register_user
Кто может вызывать
Анонимный пользователь.
Авторизованное приложение.
Принимаемые параметры
sid – идентификатор сессии анонимного пользователя, полученный ранее через запрос простой авторизации (w_create_sid) или авторизации через социальную сеть (w_authorise_socnet). Это необязательный параметр;
mail – e-mail пользователя. Это необязательный параметр, но рекомендуется максимально побуждать пользователя указывать его e-mail и/или информировать о рисках, связанных с отсутствием e-mail. Параметр является обязательным, если не указан login;
login – логин, под которым пользователь хочет зарегистрироваться (минимальная длина – 5 символов). Этот параметр является обязательным, если не указан mail;
pwd* – пароль. Должен иметь минимальную длину 5 символов;
first_name – имя;
middle_name – отчество;
last_name – фамилия;
nickname – видимое другим людям имя пользователя;
phone – номер телефона;
birth_date – дата рождения в ISO-виде 1999-12-21;
gender – пол, может принимать значения m-мужчина, f-женщина;
no_mail – запрет на отправку welcome-уведомления с логином и паролем на указанный e-mail. Доступные значения:
- 0 – (по умолчанию) welcome-уведомления разрешены;
- 1 – welcome-уведомления запрещены.
Возвращаемые значения
sid – актуальный (валидный) идентификатор сессии;
country – сведения о гео-локации пользователя в стандарте ISO 3166-1;
region – регион пользователя (необязательный параметр);
city – город пользователя (необязательный параметр);
currency – соответствующая гео-локации валюта (необязательный параметр).
Возможные ошибки
error_code | error_message | Описание |
|---|---|---|
101006 | Запрошенный логин уже занят. | В запросе передан login, уже занятый другой учетной записью. |
101007 | Логин не указан. | В запросе не передан параметр login. |
101008 | Пароль не указан. | В запросе не передан параметр pwd. |
101009 | E-mail некорректен. | Параметр mail имеет некорректный формат. |
101010 | E-mail уже принадлежит другому пользователю. | В запросе передан mail, уже занятый другой учетной записью. |
101011 | Некорректный номер телефона. | Параметр phone имеет некорректный формат. |
101012 | Телефон уже принадлежит другому пользователю. | В запросе передан phone, уже занятый другой учетной записью. |
101015 | Пароль некорректен. | Параметр pwd имеет длину менее 5 символов. Укажите более длинный пароль. |
101019 | Логин некорректен. | Параметр login имеет длину менее 5 символов. |
101020 | Превышено число регистраций с одного IP-адреса. | При последнем запросе был превышен лимит количества регистраций с одного IP-адреса. Измените IP-адрес сервера, с которого производятся запросы или обратитесь к менеджеру ЛитРес. |
Пример запроса на сервер
{
"app": "1",
"time": "2014-11-07T16:21:02+03:00",
"sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
"sid": "7bad5f2fb752ee957a4ab74aaac7711g",
"requests": [
{
"func": "w_register_user",
"id": "registermepls",
"param": {
"mail": "my@mail.ru",
"pwd": "foo_bar",
"nickname": "GribUser",
"gender": "f",
"birth_date": "1975-12-17",
}
}
]
}
Пример ответа сервера
{
"success": true,
"time": "2014-11-07T16:21:02+03:00",
"registermepls": {
"success": true,
"sid": "btw_do_not_expect_SID_to_be_a_plain_hex_baby, it's a string!",
"country": "RUS"
}
}