Отслеживание событий смены 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
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
GET
https://api.seven.tech/imsi/unsubscribe
Метод позволяет выполнить отписку от событий изменения IMSI для заданного абонента.
Path Parameters
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>
Запрос статуса подписки
GET
https://api.seven.tech/imsi/sub-status
Метод позволяет получить информацию о статусе подписки для заданного абонента
Path Parameters
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>
Примеры вызовов
https://api.seven.tech/imsi/sync-imsi?serviceid=65535&pass=passme123&phone=79031234567
Ответ сервиса
В случае успешной обработки запроса любого из методов возвращается ответ в формате XML с корневым элементом Response, который может содержать следующие параметры:
Имя
Тип данных
Описание
Id
big integer
Идентификатор транзакции
Code
integer
Код ответа
Text
string
Описание кода ответа
Вложенный элемент Payload содержит следующие параметры:
Имя
Тип данных
Описание
State
string
Статус запроса
IMSI
string
Хэшированное значение IMSI
Date
datetime
Дата в формате YYYY-mm-dd HH:MM:SS Z
Коды ответов
Code
Text
Описание
200
OK
Успешное выполнения запроса
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
phone
integer
Номер абонента в международном формате. Пример 79031234567
imsi
string
Хэшированное значение IMSI
OK
Пример вызова
https://online-finace-company.ru/imsi?phone=79031234567&imsi=9641f70524a01757c47c6b10fe7f1c97c36f877ec9b8f7c73e010416540183da
Абонент 79031234567 сменил IMSI.
Last updated