POST AI agent ready /v1/phone

API проверки телефона — бесплатный анализатор номеров

Анализирует и проверяет номер телефона. Возвращает форматированные версии (E.164, национальные), код страны и название страны.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/phone \
  -H "Content-Type: application/json" \
  -d '{"phone":"+14155552671","country":"US"}'

When to use this API

Нормализовать номера телефонов в базе данных контактов

Пользователи вводят номера телефонов в десятках форматов: «415-555-2671», «(415) 555 2671», «+1 415.555.2671». Проанализируйте каждый из них через эту конечную точку, чтобы получить стандартизированный формат E.164 для хранения. Используйте национальный_формат для отображения в пользовательском интерфейсе.

Маршрутизация SMS-сообщений по стране

Прежде чем отправлять SMS через своего поставщика услуг обмена сообщениями, подтвердите номер телефона и извлеките код страны. Направляйте сообщения через шлюзы SMS для конкретного региона, чтобы сократить расходы и повысить скорость доставки.

Блокируйте недействительные номера в формах регистрации

Подтвердите номера телефонов при отправке регистрационной формы. Немедленно отклоняйте недействительные номера и показывайте пользователям национальный формат в качестве подтверждения того, что было проанализировано, выявляя опечатки до того, как они попадут в вашу базу данных.

Frequently asked questions

Какие форматы номеров телефонов принимаются?

Конечная точка принимает международный формат (+14155552671), национальный формат ((415) 555-2671) и наиболее распространенные варианты с тире, точками и пробелами. Включение префикса кода страны дает наиболее точные результаты.

Когда мне следует использовать параметр страны?

Используйте параметр страны, если номер телефона не содержит префикса кода страны (например, «4155552671» без «+1»). Подсказка страны сообщает синтаксическому анализатору, какой план нумерации применить.

Что такое формат E.164?

E.164 — международный стандарт телефонных номеров. Он начинается с «+», за которым следуют код страны и номер абонента, без пробелов и знаков препинания. Пример: +14155552671.

Подтверждает ли это, что номер телефона обслуживается?

Нет. Эта конечная точка проверяет только формат и структуру. Он не звонит и не отправляет текстовые сообщения на номер, чтобы убедиться, что он активен.

Могу ли я проверить стационарные и мобильные номера?

Да. Анализатор обрабатывает форматы номеров стационарных и мобильных телефонов. Он проверяется на основе правил плана нумерации страны.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.