Skip to content

Оценка активности телефонного номера

checkPhoneActivity

Тип HTTP запроса: POST

URL вызова: https://api.id-x.org/idx/api2/checkPhoneActivity

Поддерживаются следующие форматы передачи параметров:

  • JSON, Content-Type: application/json

  • Form submit, Content-Type: application/x-www-form-urlencoded

Параметры:

Параметр Тип Обязательный Описание
accessKey String Да Ключ доступа, выданный при регистрации в Системе IDX
secretKey String Да Секретный ключ, выданный при регистрации в Системе IDX
phone String Да Номер телефона в формате 79991112233
agreement Boolean Да Признак согласия абонента на обработку его персональных данных

Функция возвращает:

Параметр Тип Обязательный Описание
resultCode Int Да Результат выполнения функции (0 – успешное завершение функции, -100 – данные не найдены, иные значения – ошибка выполнения)
resultMessage String Нет Сообщение об ошибке
operationToken String Нет Уникальный идентификатор операции
active Boolean Нет Признак стандартного поведения абонента в сотовой сети, наличия входящих, исходящих звонков за последние полгода

Если по номеру данные отсутствуют, то это может также означать что им никто не пользуется, либо он ни на кого не зарегистрирован, либо не имеет никаких коммуникаций с различными абонентами, то есть им фактически не пользуются, он находятся в блокировке и его скоро закроют"

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

POST /idx/api2/checkPhoneActivity
Host: api.id-x.org
Content-Type: application/json
Accept: application/json

{
    "accessKey": "выданный accessKey",
    "secretKey": "выданный secretKey",
    "phone": "79991112233",
    "agreement": true 
}

Пример успешного ответа, когда данные найдены:

{
        "resultCode": 0,
        "resultMessage": "",
        "operationToken": "82e9d6ec643242e348bbefbe4d7b",
        "active": true
}

Пример успешного ответа, когда данные НЕ найдены:

{
        "resultCode": -100,
        "resultMessage": "Номер не найден",
        "operationToken": "edeee3ec059b429089ba2d963ec4029a"
}