Аутентификация покупателей
Клиентская аутентификация необходима для оформления заказов, а так же для просмотра профиля покупателя и истории заказов.
API Zenky позволяет выполнять аутентификацию по паре телефон-пароль.
Создание профиля
Если у покупателя ещё нет аккаунта в магазине, ему необходимо пройти через процесс регистрации.
Этот процесс включает в себя два шага — создание аккаунта и его подтверждение. Так как аккаунт связывается с номером телефона покупателя, после его создания на указанный номер телефона будет отправлено сообщение с кодом подтверждения. После того, как покупатель подтвердит регистрацию, он сможет входить в свой аккаунт в магазине.
Регистрация
Для регистрации нового покупателя необходимо отправить POST
-запрос на URL
https://api.zenky.io/v2/auth/register
со следующими данными:
Поле gender
Если указывается поле gender
(пол покупателя), его значение должно быть одним из следущих:
Поле birth_date
Если указывается поле birth_date
, его значение должно быть в формате YYYY-MM-DD
(например, 1991-09-20
для даты рождения 20 сентября 1991 года
).
Возможные ошибки
Подтверждение регистрации
После создания профиля покупателю необходимо подтвердить номер телефона. Одновременно с созданием профиля на указанный номер телефона высылается код подтверждения в SMS.
Этот код необходимо передать в POST
-запрос на URL https://api.zenky.io/v2/auth/register/confirm
со следующими данными:
Ответ
После подтверждения регистрации в поле data.token
будет доступен API-токен для продолжения
работы с API под учетной записью покупателя, а в поле data.user
будет доступен объект пользователя.
Возможные ошибки
Повторная отправка кода
Для повторной отправки кода подтверждения регистрации необходимо отправить POST
-запрос на URL
https://api.zenky.io/v2/auth/register/resend
со следующими данными:
Возможные ошибки
Вход
Для входа с паролем необходимо отправить POST
-запрос на URL https://api.zenky.io/v2/auth/login
со следующими данными:
Ответ
В случае успешного входа в поле data.token
будет доступен API-токен для продолжения
работы с API под учетной записью покупателя, а в поле data.user
будет доступен объект пользователя.
Возможные ошибки
Проверка регистрации
Если необходимо проверить, зарегистрирован ли покупатель, можно отправить POST
-запрос
на URL https://api.zenky.io/v2/auth/check
со следующими данными:
Ответ
Если номер зарегистрирован и покупатель может войти с паролем, значением поля
data.registered
будет являться true
, иначе — false
.
Сброс пароля
Процесс сброса пароля включает в себя два шага — запрос на сброс пароля и его подтверждение.
В первом шаге пользователь вводит свой телефон и получает код сброса в SMS. Во втором шаге пользователь указывает код сброса и новый пароль к аккаунту.
Возможные ошибки
Запрос кода сброса пароля
Для получения кода сброса пароля необходимо отправить POST
-запрос на URL
https://api.zenky.io/v2/auth/password/request
со следующими данными:
Установка нового пароля
Для установки нового пароля необходимо отправить POST
-запрос на URL
https://api.zenky.io/v2/auth/password/reset
со следующими данными:
Ответ
В случае успешной установки нового пароля в поле data.token
будет доступен API-токен для продолжения
работы с API под учетной записью покупателя, а в поле data.user
будет доступен объект пользователя.