GetActivityScore

Метод GetActivityScore

Примените метод GetActivityScore для получения оценки телеком-доступности номеров любых операторов РФ. В ответе на запрос вы получите коэффициент активности на сети (от 0 до 1) — благодаря ему вы сможете актуализировать вашу клиентскую базу перед отправкой рассылки или запуска обзвона, убрав из неё неактивные номера.

Точка подключения: Услуга доступна в двух версиях — они отличаются по набору признаков, на основе которых формируется оценка активности. Выполните POST-запрос с входными параметрами к одной из точек подключения:

POST: https://api.exolve.ru/hlr/v1/GetActivityScore

POST: https://api.exolve.ru/hlr/v2/GetActivityScore

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON-формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

Выходные параметры

Примеры

Входные параметры:

{
    "number": "79139999999"
}

Выходные параметры, если по номеру есть информация в базе:

{
    "number": 79139999999,
    "result": "0.96",
    "owner_id": "mMTS",
    "region_code": 77
}

Выходные параметры, если по номеру нет информации в базе (вероятно, с этого номера не было звонков в течение 2 последних лет) — такой запрос также считается успешным и тарифицируется:

{
    "error": {
        "message": "no information on this number"
    }
}

Возможные ошибки