Отслеживание событий смены IMSI

IMSI — уникальный идентификатор SIM-карты, международный идентификатор мобильного абонента. Сервис позволяет получить значение IMSI по номеру телефона абонента, а так же отследить событие смены IMSI.

Запуск сервиса

Для запуска сервиса IMSI в рамках протокола HTTP партнеру необходимо получить реквизиты доступа к API:

serviceid — уникальный идентификатор сервиса;
pass — пароль.

Во всех случаях сервис возвращает хэшированное значение IMSI, которое отличается от реальной нумерации SIM-карт, это обусловлено политикой операторов сотовой связи. Данная особенность не влияет на отслеживание смены значения IMSI.

Подписаться на получения событий смены IMSI

GET https://api.seven.tech/imsi/sync-imsi

Метод позволяет получить значение IMSI по заданному абоненту и одномоментно выполнить подписку для дальнейшего отслеживания изменения IMSI для него.

Path Parameters

Name

Type

Description

serviceid

integer

Идентификатор сервиса от которого происходит запрос

pass

string

Пароль для доступа к сервису

phone

integer

Номер абонента в международном формате. Пример 79031234567

/* Успешный статус транзакции: возврат значения IMSI, абонент подписан */
<Response>
<Id>16777216</Id>
<Code>200</Code>
<Text>OK</Text>
<Payload>
  <State>COMPLETE</State>
  <IMSI>9641f70524a01757c47c6b10fe7f1c97c36f877ec9b8f7c73e010416540183da</IMSI>
  <Date>2019-02-22 10:57:10 +0300</Date>
</Payload>
</Response>

/* Получение IMSI для данного абонента невозможна */
<Response>
<Id>16777216</Id>
<Code>200</Code>
<Text>OK</Text>
<Payload>
  <State>NOT_SUPPORTED</State>
</Payload>
</Response>

/* IMSI для данного номера не зарегистрирован */
<Response>
<Id>16777216</Id>
<Code>200</Code>
<Text>OK</Text>
<Payload>
  <State>NOT_REGISTERED</State>
</Payload>
</Response>

/* Отсутствуют или неверно заданы обязательные параметры */
<Response>
<Code>400</Code>
<Text>parameter 'phone' must be a number</Text>
</Response>

/* Передано неверное сочетание пары serviceId и pass /
<Response>
<Code>403</Code>
<Text>invalid login or password</Text>
</Response>

Отписаться от получений событий смены IMSI

GET https://api.seven.tech/imsi/unsubscribe

Метод позволяет выполнить отписку от событий изменения IMSI для заданного абонента.

Path Parameters

Name

Type

Description

serviceid

integer

Идентификатор сервиса от которого происходит запрос

pass

string

Пароль для доступа к сервису

phone

integer

Номер абонента в международном формате. Пример 79031234567

/* Абонент отписан */
<Response>
<Id>16777216</Id>
<Code>200</Code>
<Text>OK</Text>
<Payload>
  <State>COMPLETE</State>
  <Date>2019-02-22 10:57:10 +0300</Date>
</Payload>
</Response>

/* Номер не был в подписке */
<Response>
<Id>16777216</Id>
<Code>200</Code>
<Text>OK</Text>
<Payload>
  <State>NOT_REGISTERED</State>
</Payload>
</Response>

/* Получение IMSI для данного абонента невозможна */
<Response>
<Id>16777216</Id>
<Code>200</Code>
<Text>OK</Text>
<Payload>
  <State>NOT_SUPPORTED</State>
</Payload>
</Response>

/* Отсутствуют или неверно заданы обязательные параметры */
<Response>
<Code>400</Code>
<Text>parameter 'phone' must be a number</Text>
</Response>

/* Передано неверное сочетание пары serviceId и pass /
<Response>
<Code>403</Code>
<Text>invalid login or password</Text>
</Response>

Запрос статуса подписки

GET https://api.seven.tech/imsi/sub-status

Метод позволяет получить информацию о статусе подписки для заданного абонента

Path Parameters

Name

Type

Description

serviceid

integer

Идентификатор сервиса от которого происходит запрос

pass

string

Пароль для доступа к сервису

phone

integer

Номер абонента в международном формате. Пример 79031234567

/* абонент подписан */
<Response>
<Id>16777216</Id>
<Code>200</Code>
<Text>OK</Text>
<Payload>
  <State>SUBSCRIBED</State>
  <Date>2019-02-22 10:57:10 +0300</Date>
</Payload>
</Response>

/* Номер не подписан */
<Response>
<Id>16777216</Id>
<Code>200</Code>
<Text>OK</Text>
<Payload>
  <State>NOT_REGISTERED</State>
</Payload>
</Response>

/* Получение IMSI для данного абонента невозможна */
<Response>
<Id>16777216</Id>
<Code>200</Code>
<Text>OK</Text>
<Payload>
  <State>NOT_SUPPORTED</State>
</Payload>
</Response>

/* Отсутствуют или неверно заданы обязательные параметры */
<Response>
<Code>400</Code>
<Text>parameter 'phone' must be a number</Text>
</Response>

/* Передано неверное сочетание пары serviceId и pass /
<Response>
<Code>403</Code>
<Text>invalid login or password</Text>
</Response>

Примеры вызовов

https://api.seven.tech/imsi/sync-imsi?serviceid=65535&pass=passme123&phone=79031234567

https://api.danytech.ru/imsi/unsubscribe?serviceid=65535&pass=passme123&phone=79031234567

https://api.danytech.ru/imsi/sub-status?serviceid=65535&pass=passme123&phone=79031234567

Ответ сервиса

В случае успешной обработки запроса любого из методов возвращается ответ в формате XML с корневым элементом Response, который может содержать следующие параметры:

Имя

Тип данных

Описание

big integer

Идентификатор транзакции

Code

integer

Код ответа

Text

string

Описание кода ответа

Вложенный элемент Payload содержит следующие параметры:

Имя

Тип данных

Описание

State

string

Статус запроса

IMSI

string

Хэшированное значение IMSI

Date

datetime

Дата в формате YYYY-mm-dd HH:MM:SS Z

Коды ответов

Code

Text

Описание

200

Успешное выполнения запроса

400

parameter 'phone' must be a number

Отсутствуют обязательные параметры или заданы некорректные значения параметров

403

invalid login or password

Передана неверная пара serviceId и pass

Пример ответа

<Response>
<Id>16777216</Id>
<Code>200</Code>
<Text>OK</Text>
<Payload>
  <State>COMPLETE</State>
  <IMSI>9641f70524a01757c47c6b10fe7f1c97c36f877ec9b8f7c73e010416540183da</IMSI>
  <Date>2019-02-22 10:57:10 +0300</Date>
</Payload>
</Response>

Получение событий смены IMSI

GET https://online-finace-company.ru/imsi

Метод передает информацию о событии смены IMSI абонентом. Платформа SevenTech инициирует запрос в сторону партнера. Партнеру необходимо реализовать обработчик на своей стороне и сообщить URL.

Path Parameters

Name

Type

Description

phone

integer

Номер абонента в международном формате. Пример 79031234567

imsi

string

Хэшированное значение IMSI

OK

System error

Пример вызова

https://online-finace-company.ru/imsi?phone=79031234567&imsi=9641f70524a01757c47c6b10fe7f1c97c36f877ec9b8f7c73e010416540183da

Абонент 79031234567 сменил IMSI.

PreviousПолучения статусов доставки NextКанал 2way

Last updated 4 years ago