Проверка номеров телефонов на существование (HLR-запросы). JSON API

Запрос для получения результата проверки номера на существование (HLR-запроса)


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

Тело запроса
{
    "login":"username",
    "password":"password",
    "command":"hlr_status",
    "status":{
		"msg":[
			{"hlr_code":123456},
			{"hlr_code":123457}
		]
	}
}
Описание параметров и тегов в запросе
login
ваш логин, для доступа в Личный кабинет (ЛК)

password
ваш пароль к API, который генерируется на странице «SMS-рассылка» — «Рассылка по API»

msg
массив идентификаторов HLR-запросов, для которых происходит запрос статуса, может содержать следующие атрибуты:
hlr_code
числовой идентификатор HLR-запроса, который вы получили в момент отправки
Ответ с результатами проверки номера на существование (HLR-запроса)

Тело ответа
пример при проверке номера 375295363600 на существование
{
	"status":{
		"msg":[
			{
				"error":0,
				"hlr_id":123456,
				"hlr_status":"Delivered"	,
				"recipient":"375295363600",
				"hlr_error_code":"0",
				"hlr_error_name":"NO_ERROR",
				"hlr_error_desc":"No Error",
				"hlr_error_permanent":"0",
				"hlr_original_tp_name":"MTS (JLLC Mobile TeleSystems)",
				"hlr_original_tp_prefix":"295",
				"hlr_original_c_name":"Belarus",
				"hlr_original_c_prefix":"375",
				"hlr_ported":"0",
				"hlr_ported_tp_name":"",
				"hlr_ported_tp_prefix":"",
				"hlr_ported_c_name":"",
				"hlr_ported_c_prefix":""
			}
		]
	}
}
Описание тегов в ответе
msg
массив с информацией HLR-запроса. Может содержать следующие параметры:
error
код ошибки. В случае успешного ответа значение 0
hlr_id
числовой идентификатор HLR-запроса, который вы получили в момент отправки
hlr_status
статус HLR-запроса
recipient
номер телефона, по которому осуществлялась проверка на существование (HLR-запрос) в допустимом формате
hlr_error_code
код GSM ошибки. В случае успешного ответа значение 0
hlr_error_name
наименование ошибки GSM. В случае успешного ответа значение «NO_ERROR"
hlr_error_desc
описание GSM ошибки. В случае успешного ответа значение «No Error»
hlr_error_permanent
постоянность ошибки
hlr_original_tp_name
первоначальный мобильный оператор

hlr_original_tp_prefix
DEF код (префикс) оригинального мобильного оператора
hlr_original_c_name
первоначальная страна
hlr_original_c_prefix
первоначальный код страны
hlr_ported
указывает портированность номера (перенесён ли номер к другому мобильному оператору)
hlr_ported_tp_name
оператор, к которому перенесён (портирован) номер
hlr_ported_tp_prefix
DEF код (префикс) мобильного оператора, к которому перенесён (портирован) номер
hlr_ported_c_name
страна мобильного оператора, к которому перенесён (портирован) номер
hlr_ported_c_prefix
код страны мобильного оператора, к которому перенесён (портирован) номер
Ответ в случае ошибки формирования запроса

Тело ответа
{"error":КОД_ОШИБКИ}
Описание тегов в ответе
error
содержит код ошибки
Ещё в этом разделе