GetHLRListBestCallTime

Метод GetHLRListBestCallTime

Примените метод GetHLRListBestCallTime для получения истории запросов по интервалам времени, в течение которых наиболее высока вероятность дозвониться до ваших клиентов.


ВАЖНО! Получить историю запросов пока можно только по номеру оператора МТС. Остальные операторы будут доступны позднее


Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:

POST: https://api.exolve.ru/statistics/hlr/v1/GetHLRListBestCallTime

Авторизация

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

ИмяТипОписание
AuthorizationstringAPI-ключ приложения с Bearer перед ним. Пример: Bearer e***s0, где e***s0 замените на API-ключ вашего приложения

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

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

ПараметрТипОписание
date_fromstringдата начала выборки запросов в формате RFC-3339 / ISO-8601
date_tostringдата окончания выборки запросов в формате RFC-3339 / ISO-8601
limituint32лимит выводимых строк
offsetuint64номер строки, с которой начинать выборку (начинается с 0)

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

ПараметрТипОписание
elementsElementsномер, по которому получено лучшее время для звонка

Elements

ПараметрТипОписание
application_uuidstringидентификатор приложения, bp которого отправлены запросы
create_datestringдата отправки запроса
numberuint64номер, по которому получено лучшее время для звонка
resultstringинтервал времени в UTC+0, в течение которого абонент вероятнее всего ответит на звонок

Примеры

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

{
    "date_from": "2023-10-01T08:49:28.446495Z",
    "date_to":"2025-11-29T08:49:28.446495Z",
    "limit": 10,
    "offset": 0
}

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

{
    "elements": [
        {
            "application_uuid": "8403eaef-01ed-4161-93fd-cd0c2e8ce3cf",
            "create_date": "2024-11-27T13:52:02.393979Z",
            "number": "7913765XXXX",
            "result": "17:00:00,21:00:00"
        },
        {
            "application_uuid": "8403eaef-01ed-4161-93fd-cd0c2e8ce3cf",
            "create_date": "2024-10-11T14:06:11.074975Z",
            "number": "7950880XXXX",
            "result": "15:00:00,16:00:00"
        },
        {
            "application_uuid": "8403eaef-01ed-4161-93fd-cd0c2e8ce3cf",
            "create_date": "2024-10-28T08:48:58.537060Z",
            "number": "7995880XXXX",
            "result": "3:00:00,5:00:00"
        }
    ]
}

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

КодСтатусПример сообщенияОписание
400Bad Requestinvalid google.protobuf.Timestamp value ""неверный формат данных в запросе или отсутствуют обязательные параметры
400Bad Requestunexpected tokenне задано значение в одном из полей (с указанием строки)
401Unauthorizederror while trying to get token from headerнет заголовка авторизации
401Unauthorizedfailed to parse tokenневалидный API-ключ
404Not Foundнекорректно введен URL запроса