Бесплатный тест API
CallPassword ID

API интеграция CallPassword ID

CallPassword ID от Нью-Тел — это современный сервис подтверждения номера телефона без SMS, который легко интегрируется в сайт или мобильное приложение через API.

Сервис позволяет заменить SMS-коды на авторизацию по звонку, снизить расходы на верификацию и повысить безопасность регистрации.

API CallPassword ID подходит для:

• интернет-магазинов

• мобильных приложений

• сервисов доставки

• программ лояльности

• проектов с высокой долей спама и ботов

Как работает интеграция CallPassword ID

Адрес API

Все запросы выполняются по HTTPS:

https://api.new-tel.net/

Важно: клиентская сторона должна проверять SSL-сертификат сервера, чтобы исключить утечки данных.

Аутентификация запросов

Аутентификация запросов

Каждый запрос должен содержать заголовок:

authorization: Bearer { token }

Bearer-токен формируется динамически для каждого запроса и включает:

• ключ авторизации

• Unix timestamp

• SHA-256 подпись запроса

Формат запросов

Все методы API используют POST-запросы, параметры передаются в теле:

• application/json

• application/x-www-form-urlencoded

• content-type: application/json

Данные должны быть в UTF-8 без лишних пробелов и переносов строк.

Лимиты API

Ограничение: не более 10 запросов в секунду с одного IP

Актуальные лимиты возвращаются в заголовках x-rate-limit-*.

Основные методы CallPassword ID

Все методы находятся в группе:

Доступны три режима подтверждения:

• busy — без ответа, сигнал «занято»

• answer — с ответом абоненту

• progress — проигрывание сообщения вместо гудков

Инициирование верификации (режим busy)

Метод:

Пример запроса:

{
  "callbackLink": "https://example.com/webhook",
  "clientNumber": "79991112233",
  "timeout": 120,
  "userData": "order-123"
}
						

Параметры:

• callbackLink — webhook для результата

• clientNumber — номер пользователя

• timeout — ожидание звонка (по умолчанию 60 сек)

• userData — любые данные вашего проекта

Ответ API

API возвращает объект callDetails, содержащий:

• callId — UUID звонка

• confirmationNumber — номер, на который нужно позвонить

• qrCodeUri — QR-код для быстрого звонка

• оператор и регион номера пользователя

Верификация с ответом (answer)

Метод подходит, если нужно зафиксировать снятие трубки:

Верификация с сообщением (progress)

Режим, при котором пользователю воспроизводится аудиофайл вместо гудков

Важно: клиентская сторона должна проверять SSL-сертификат сервера, чтобы исключить утечки данных.

Webhook: получение результата подтверждения

После успешного звонка Нью-Тел отправляет POST-запрос на ваш callbackLink.

Webhook содержит:

• callId

• clientNumber

• confirmationNumber

• mode

• регион и оператор

• userData

Пример:

{
  "callbackLink": "https://example.com/webhook",
  "clientNumber": "79991112233",
  "timeout": 120,
  "userData": "order-123"
}
						

Ответ вашего сервера не проверяется системой.

Почему API CallPassword ID лучше SMS

• дешевле SMS-кодов

• оплата только за успешные подтверждения

• защита от ботов

• нет риска перехвата кода

• удобная интеграция через API