Вход в аккаунт через звонок CallPassword
📡 Вход в приложение через звонок#
Ручка#
ws /ws/v1/sign_in_with_call_password
Полный адрес в сети#
| Среда | URL |
|---|---|
| 🧪 Dev | ws://web-socket-gateway.devterra.ru/ws/v1/sign_in_with_call_password |
| 🚀 Prod | ws://web-socket-gateway.terraprod.ru/ws/v1/sign_in_with_call_password |
Входные данные для верификации#
| Поле | Тип | Описание | Обязательное | Пример |
|---|---|---|---|---|
| contact | string | Введенный номер телефона | ✅ | +7 999 123-12-12 |
Номер телефона можно ввести в любом формате. Он будет провалидирован и отформатирован
Система держит в пямяти подтвержденный телефон какое-то время. Это значит, что при повторном запросе пользователю сразу будет возвращен ключ авторизации
Пример JSON запроса#
Стандартная строка
{
"contact": "+7 999 123-45-67"
}
Base64 формат
{
"contact": "Nzk1MDEwNTk2NjI="
}
Выходные данные, которые будут в ответе#
| Поле | Тип | Описание | Обязательное | Пример |
|---|---|---|---|---|
| qrCodeURI | string | Ссылка на qr код для звонка | ❌ | https://files.new-tel.net/cv/qr/03a2ab09-b974-47f3-b6c8-17be5cea92ea.png |
| confirmationNumber | string | Телефон на который нужно позвонить | ❌ | 74997547005 |
| apiKey | string | Ключ авторизации | ❌ | 827d4962-0c9c-45c1-9c34-a8ca5a554900 |
| isUserCall | bool | Позвонил ли пользователь на данный момент | ✅ | true |
| isPing | bool | Является ли данное сообщение пингом | ✅ | true |
Пример JSON ответов#
Первое сообщение отправляемое пользователю
{
"qrCodeURI": "https://api.new-tel.net/files/qr-code/call-password-id/3310a0df-bb42-4dd1-a4a5-3bc742f65291.png",
"confirmationNumber": "74997547005",
"apiKey": null,
"isUserCall": false,
"isPing": false
}
Пока пользователь не позвонил
Будет отправляться пользователю с периодичностью раз в 10 секунд (клиенту следует отправлять на сервер понговое сообщение в любом формате)
{
"qrCodeURI": "https://api.new-tel.net/files/qr-code/call-password-id/3310a0df-bb42-4dd1-a4a5-3bc742f65291.png",
"confirmationNumber": "74997547005",
"apiKey": null,
"isUserCall": false,
"isPing": true
}
Когда пользователь позвонил и был произведен вход в аккаунт
{
"qrCodeURI": "https://api.new-tel.net/files/qr-code/call-password-id/3310a0df-bb42-4dd1-a4a5-3bc742f65291.png",
"confirmationNumber": "74997547005",
"apiKey": "e51d29ca-0340-417c-b78c-60bb0ae03d81",
"isUserCall": true,
"isPing": false
}
В случае ошибки
{
"showError": true,
"message": "Пользователь не найден",
"statusCode": 404,
"traceID": "c8c30b0c531d50fa76544284bead568a",
"description": "AUTH_SERVICE.USER_NOT_FOUND"
}