Метод, описанный в этой статье, предназначен только для SME.
В результате выполнения запроса будет выполнена проверка и валидация абонентского номера. Номер телефона получателя phoneNumber
следует указывать без ведущего знака «+» перед номером. Например, вот так: 79000000000
. Это касается как российских, так и международных номеров.
URL-адрес подключения
Для проверки валидности номера выполняется GET-запрос на URL-адрес: https://sms.edna.ru/connector_sme/api/validatePhoneNumber/{phoneNumber}
Параметры запроса
Запрос имеет один обязательный параметр phoneNumber
, который передается как часть URL.
Формат ответа
В ответ на запрос возвращается JSON-объект с проверенным номером. Статусы обработки номера приведены здесь. В случае неправильно заданного номера, значение ключа status
будет ERROR
в возвращеном JSON-объекте. Номер, приведенный к правильному формату находся в параметре normalize
.
{ "status": "OK", "operator": "МТС", "region": "Кемеровская область", "country": "Russia", "normalize": "79000000000" }
Иностранный абонентский номер
Если иностранный номер будет распознан, то вернется успешный статус с заполненной записью country
соответсвующей страны. Если же номер будет невалиден или не определена страна, то значение ключа status
будет ERROR
. Статусы обработки номера приведены здесь.
{ "status": "OK", "operator": "Beeline", "region": "Beeline", "country": "kazakhstan", "normalize": "77000000000" }
Параметры ответа
Параметр | Тип данных | Описание |
status | string (required) | Статус обработки номера телефона. Возможные значения |
operator | string (required) | Оператор телефонного номера |
region | string (required) | Регион телефонного номера |
country | string (required) | Страна сотового оператора |
normalize | string (required) | Правильный обработанный номер |