Метод 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 | мобильный номер в формате 7ХХХХХХХХХХ, по которому нужно узнать лучшее время для звонка |
Выходные параметры
| Параметр | Тип | Описание |
|---|---|---|
| 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 | услуга умной проверки номеров отключена, подключите её в настройках приложения |
| 400 | Bad Request | customer has not signed, the number must match your confirmed phone number | на тестовом периоде можно проверить только свой подтверждённый номер, в запросе указан иной |
| 400 | Bad Request | incorrect request | неверный запрос |
| 400 | Bad Request | customer is not active | аккаунт заблокирован |
| 401 | Unauthorized | incorrect authorization token | невалидный API-ключ |
| 403 | Forbidden | нет доступа к данными с предоставленным API-ключом | |
| 404 | Not Found | некорректно введен URL запроса |