Отслеживание событий смены 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
GET
https://api.seven.tech/imsi/unsubscribe
Метод позволяет выполнить отписку от событий изменения IMSI для заданного абонента.
Path Parameters
Name | Type | Description |
---|---|---|
serviceid | integer | Идентификатор сервиса от которого происходит запрос |
pass | string | Пароль для доступа к сервису |
phone | integer | Номер абонента в международном формате. Пример 79031234567 |
Запрос статуса подписки
GET
https://api.seven.tech/imsi/sub-status
Метод позволяет получить информацию о статусе подписки для заданного абонента
Path Parameters
Name | Type | Description |
---|---|---|
serviceid | integer | Идентификатор сервиса от которого происходит запрос |
pass | string | Пароль для доступа к сервису |
phone | integer | Номер абонента в международном формате. Пример 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 |
Пример ответа
Получение событий смены IMSI
GET
https://online-finace-company.ru/imsi
Метод передает информацию о событии смены IMSI абонентом. Платформа SevenTech инициирует запрос в сторону партнера. Партнеру необходимо реализовать обработчик на своей стороне и сообщить URL.
Path Parameters
Name | Type | Description |
---|---|---|
phone | integer | Номер абонента в международном формате. Пример 79031234567 |
imsi | string | Хэшированное значение IMSI |
Пример вызова
Абонент 79031234567 сменил IMSI.
Last updated