Данный пакет содержит в себе ответ провайдера на запрос 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>