Стандартизация телефонного номера

Стандартизация телефонного номера #

Метод стандартизации телефонного номера

Адрес метода #

POST /clean/phone

Функциональность #

  • очищает входящие данные от лишних символов для поиска телефона;
  • обеспечивает валидацию (проверку) телефонных номеров;
  • форматирует номер в международный стандарт;
  • форматирует номер в национальный стандарт;
  • форматирует номер в E164 стандарт;
  • форматирует номер в RFC3966 стандарт;
  • определяет оператора связи за которым закреплен номер;
  • определяет часовой пояс;
  • определяет тип номера стационарный или мобильный.

Параметры запроса #

ПараметрОписание
numberТелефонный номер для стандартизации
countryCodeКод страны, которой принадлежит номер, в формате ISO 3166 (https://www.iso.org/iso-3166-country-codes.html)

Пример данных запроса #

{
  "query": "+79119111111",
  "countryCode": "RU"
}

Параметры ответа #

ПараметрОписание
originalВходящая строка с номером, которая участвовала в стандартизации
internationalНомер в международном формате
nationalНомер в национальном формате (внутреннем)
E164Номер в E164 формате
RFC3966Номер в RFC3966 формате
carrierТелефонный оператор, которому принадлежит номер
countryCodeТелефонный код страны
countryКод страны в формате ISO 3166
areaCodeКод региона
timezonesСписок часовых поясов к которым принадлежит номер
typeТип телефонного номера мобильный или стационарный
validПризнак корректности разобранного номера

Пример данных ответа #

{
  "original": "+79119111111",
  "international": "+7 911 911-11-11",
  "national": "8 (911) 911-11-11",
  "E164": "+79119111111",
  "RFC3966": "tel:+7-911-911-11-11",
  "carrier": "",
  "countryCode": 7,
  "country": "RU",
  "areaCode": "",
  "timezones": [
    "Europe/Moscow"
  ],
  "geocoding": "",
  "subscriberNumber": "9119111111",
  "type": "MOBILE",
  "possible": true,
  "valid": true
}