Данный пакет содержит в себе ответ провайдера на запрос provideSubscriberImsiRequest
. В ответе содержится массив IMSI-идентификаторов для запрашиваемых адресов и/или код ошибки, по причине которой возврат запрашиваемого параметра невозможен.
Если пакет содержит в себе данные, кодировка которых не входит в таблицу символов ASCII, данные должны быть в кодировке UTF-8.
Следует отметить, что порядок объектов в массиве результатов может не совпадать с порядком соответствующих объектов в исходном массиве адресов, поэтому, при пакетных операциях, когда в исходном массиве содержится более одного элемента, связку адресов и IMSI SIM-карты на стороне клиента необходимо производить, используя адрес в качестве ключа.
Пример пакета
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <provideSubscriberImsiResponse> <header/> <payload> <code>ok</code> <subscriberAddressList> <subscriberAddress> <address>79876543210</address> <code>ok</code> <subscriberImsi> <imsi>5155A8479986BF7E92A41155DEDE4FA9</imsi> </subscriberImsi> </subscriberAddress> <subscriberAddress <address>79876543211</address> <code>error-address-invalid</code> </subscriberAddress> <subscriberAddress> <address>79876543212</address> <code>error-service-error</code> <serviceError>absent-subscriber</serviceError> </subscriberAddress> </subscriberAddressList> </payload> </provideSubscriberImsiResponse>
Описание параметров пакета
provideSubscriberImsiRequest/payload/code |
Описание | Общий статус запроса |
Тип данных | Строковое значение |
Обязательное поле | Да |
provideSubscriberImsiRequest/payload/subscriberAddressList/subscriberAddress/address |
Описание | Адрес абонента. Номер мобильного телефона абонента в международном формате (в формате E.164) |
Тип данных | Строковое значение. Положительные целые числа |
Обязательное поле | Да |
provideSubscriberImsiRequest/payload/subscriberAddressList/subscriberAddress/code |
Описание | Статус запроса по указанному в запросе адресу. Провайдер так же использует это поле для возврата кода ошибки, список возможных кодов приведен в статье Статусы запросов. |
Тип данных | Строковое значение |
Обязательное поле | Да |
provideSubscriberImsiRequest/payload/subscriberAddressList/subscriberAddress/ subscriberImsi |
Описание | IMSI-идентификатор SIM-карты абонента |
Тип данных | Строковое значение |
Обязательное поле |
provideSubscriberImsiRequest/payload/subscriberAddressList/subscriberAddress/ serviceError |
Описание | Данное поле содержит код ошибки сигнальной сети, наиболее часто встречающиеся значения указаны в статье Возможные коды ошибок сигнальной сети. |
Тип данных | Строковое значение |
Обязательное поле |
XML-схема пакета
<?xml version="1.0" encoding="UTF-8"?> <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xsd:element name="provideSubscriberImsiResponse"> <xsd:complexType> <xsd:sequence> <xsd:element name="header"></xsd:element> <xsd:element name="payload"> <xsd:complexType> <xsd:sequence> <xsd:element name="code" type="xsd:string"></xsd:element> <xsd:element name="subscriberAddressList"> <xsd:complexType> <xsd:sequence> <xsd:element name="subscriberAddress" maxOccurs="unbounded"> <xsd:complexType> <xsd:sequence> <xsd:element name="address" type="xsd:string"></xsd:element> <xsd:element name="code" type="xsd:string"></xsd:element> <xsd:element name="subscriberImsi"> <xsd:complexType> <xsd:sequence> <xsd:element name="imsi" type="xsd:string"></xsd:element> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:schema>