GetBestCallTime

Метод GetBestCallTime

Примените этот метод для получения периода времени, в течение которого наиболее высока вероятность дозвониться до вашего клиента. Для этого выполните POST-запрос с входными параметрами к точке подключения, указанными ниже.

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

Точка подключения:

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

Авторизация

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

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

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

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

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

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

Параметр Тип Описание
number uint64 номер, по которому получено лучшее время для звонка
result string интервал времени в UTC+0, в течение которого абонент вероятнее всего ответит на звонок

Примеры

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

{
    "number": "79139999999"
}

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

{
    "number": 79139999999,
    "result": "17:00:00,21:00:00"
}

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

Код Статус Пример сообщения Описание
400 Bad Request incorrect number format неверный формат данных в запросе или отсутствуют обязательные параметры
400 Bad Request enter another number введите номер оператора МТС
400 Bad Request hlr is disabled on the application услуга HLR-запросов отключена, подключите её в настройках приложения
400 Bad Request customer has not signed, the number must match your confirmed phone number на тестовом периоде можно проверить только свой подтверждённый номер, в запросе указан иной
401 Unauthorized malformed token невалидный API-ключ
403 Forbidden нет доступа к данными с предоставленным API-ключом
404 Not Found сервер не может найти запрошенный ресурс

Содержание статьи