Аутентификация покупателей


Клиентская аутентификация необходима для оформления заказов, а так же для просмотра профиля покупателя и истории заказов.

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 будет доступен объект пользователя.