Узнать IMSI текущей SIM-карты абонента по номеру телефона
Модуль IMSI теперь называется «Инфообмен». В интерфейсе edna Prisma и в API некоторые элементы пока могут называться по-старому — IMSI.
Метод для запроса уникального IMSI-идентификатора используемой на данный момент SIM-карты абонента.
Аутентификационные данные и массив адресов абонентов передаются в качестве параметров.
Адрес абонента должен быть уникален в рамках одного вызова provideSubscriberImsi
Аутентификация
Для всех методов используются параметры в секции header/auth:
| Параметр | Тип данных | Характер | Описание |
|---|---|---|---|
login | string | Обязательный | Логин клиента. |
password | string | Обязательный | Пароль клиента. |
Формат запроса provideSubscriberImsiRequest
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<provideSubscriberImsiRequest>
<header>
<auth>
<login>bank</login>
<password>*****</password>
</auth>
</header>
<payload>
<subscriberAddressList>
<subscriberAddress>
<address>79876543210</address>
</subscriberAddress>
</subscriberAddressList>
</payload>
</provideSubscriberImsiRequest>
Параметры запроса
| Параметр | Тип данных | Характер | Описание |
|---|---|---|---|
header.auth.login | string | Обязательный | Имя пользователя в платформе провайдера. Выдаётся клиенту провайдером на этапе подключения к платформе. |
header.auth.password | string | Обязательный | Пароль пользователя клиента в платформе провайдера. Выдаётся клиенту провайдером на этапе подключения к платформе. |
subscriberAddress.address | string | Обязательный | Номер телефона абонента, по которому запрашивается IMSI. Допустимые значения: положительные целые числа; номер в международном формате E.164. |
XSD-схема
Раскройте, чтобы просмотреть схему
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
<xsd:element name="provideSubscriberImsiRequest">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="header">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="auth">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="login" type="xsd:string"/>
<xsd:element name="password" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="payload">
<xsd:complexType>
<xsd:sequence>
<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: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>
Формат ответа provideSubscriberImsiResponse
В ответе содержится массив IMSI-идентификаторов для запрашиваемых адрес ов и/или код ошибки, по причине которой возврат запрашиваемого параметра невозможен. Если пакет содержит в себе данные, кодировка которых не входит в таблицу символов ASCII, данные должны быть в кодировке UTF-8.
Порядок элементов в ответе может не совпадать с порядком номеров в запросе. Для сопоставления результатов используйте поле address как ключ.
<?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>
</subscriberAddressList>
</payload>
</provideSubscriberImsiResponse>
Параметры ответа
| Параметр | Тип данных | Характер | Описание |
|---|---|---|---|
payload.code | string | Обязательный | Общий статус запроса. |
subscriberAddress.address | string | Обязательный | Адрес абонента — номер мобильного телефона в международном формате E.164. Тип — строка. Положительные целые числа в записи номера. |
subscriberAddress.code | string | Обязательный | Статус запроса по указанному в запросе адресу. Провайдер также использует это поле для возврата кода ошибки. Коды ответов и ошибки |
subscriberAddress.subscriberImsi.imsi | string | Необязательный | IMSI-идентификатор SIM-карты абонента (внутри элемента subscriberImsi). |
subscriberAddress.serviceError | string | Необязательный | Код ошибки сигнальной сети. Коды ответов и ошибки |
XSD-схема
Раскройте, чтобы просмотреть схему
<?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 name="payload">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="code" type="xsd:string"/>
<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 name="code" type="xsd:string"/>
<xsd:element name="subscriberImsi">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="imsi" type="xsd:string"/>
</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>