checkPhone

Проверяет телефон по справочнику DEF, определяет оператора, заполняет страну, город.

  • Проверяет телефон.
  • Проставляет актуальный код города / DEF-код.
  • Восстанавливает оператора.
  • Определяет страну, регион, город.

Этот метод можно вызывать с использованием аутентификации

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

CURL

curl https://api.ucaller.ru/v1.0/checkPhone \
  -X "GET" \
  -H "Authorization: Bearer <Секретный ключ вашего сервиса>.<Идентификатор сервиса>"
  -d '{"phone":"+7 909 100-00-00"}'

GET

 https://api.ucaller.ru/v1.0/checkPhone?phone=+7 909 100-00-00&key=<Секретный ключ вашего сервиса>&service_id=<Идентификатор сервиса>

В ходе выполнения могут произойти общие ошибки. Их описание находится на отдельной странице →

Параметры

Метод принимает следующие параметры:

ПАРАМЕТРЫ
ОПИСАНИЕ
phone
string, required
Номер телефона

Пример ответа

{
  "source": "+7 909 100-00-00",
  "error": "Invalid phone number",
  "mobile": 1,
  "phone": 79091000000,
  "country_iso": "RU",
  "country_code": 7,
  "mnc": 99,
  "number": 9091000000,
  "provider": "Beeline",
  "company": "ОАО \"Вымпел-Коммуникации\"",
  "country": "Россия",
  "region": "Пермский край",
  "city": "Пермь",
  "phone_format": "+7 909 100-00-00",
  "cost": 0.04,
  "balance": 50.48
}

Результат

Метод возвращает объект, содержащий следующие поля:

ПАРАМЕТРЫ
ОПИСАНИЕ
source
string
Исходный телефон одной строкой
error
strings, optional
Ошибка появляется в случае не валидного номера телефона
mobile
number
Тип номерая, мобильный = 1, не мобильный = 0
phone
number
Номер телефона в формате E.164
country_iso
strings
ISO код страны ISO 3166-1 alpha-2
country_code
number
Код страны
mnc
number
Код мобильной сети
number
number
Локальный номер телефона без кода страны
provider
string
Оператор связи
company
string
Компания (огранизация) оператора связи (только для России)
country
string
Страна
region
string
Регион (только для России)
city
string
Город (только для России)
phone_format
string
Номер телефона в национальном формате
cost
number
Стоимость услуги
balance
number
Текущий баланс аккаунта