Документація API керування викликами

Швидкий старт

Базова URL-адреса

Приклади

Аутентифікація

Кінцеві точки керування викликами автентифікуються за допомогою apikey параметр запиту.

Загальні поняття

Пагінація

використання ліміт і зміщення для пагінації результатів.

Позначки часу

• дата_дзвінка_мс є міткою часу UNIX у мілісекунди.
• дата_час_дзвінка UTC зберігається як рядок дати та часу UTC (поле бази даних).
• Для пропущених дзвінків API повертає відформатований дата рядок (походить зі значення мілісекунд).

Пошук

• Пропущені дзвінки: пошук збігається з числом або ім'ям.
• Вхідні/Вихідні: q матчі номер_телефону або кешована_ім'я.

Сортування (лише вхідні/вихідні)

Сортування контролюється сортувати_за + каталог_сортування (лише поля з білого списку). Пропущені дзвінки завжди відображаються в порядку найновіших.

Помилки

Примітка: кінцева точка пропущених дзвінків також може повертати такі повідомлення, як Відсутній apikey або помилки підготовки SQL залежно від ситуації.

Пропущені дзвінки – Список

Отримання пропущених дзвінків, синхронізованих з мобільного пристрою.

Кінцева точка

Параметри запиту

Приклад запиту

Приклад JSON-відповіді

{ "success": true, "offset": 0, "limit": 100, "count": 3, "data": [ { "number": "+15551230001", "name": "", "date": "2026-03-20 16:12:28" }, { "number": "+15551230002", "name": "Алекс Картер", "date": "2026-03-20 16:12:00" }, { "number": "+447700900123", "name": "Тейлор Рід", "date": "2026-03-20 15:48:41" } ] }

Пояснення відповіді

Вхідні дзвінки – Список

Отримувати вхідні відповіді на дзвінки, синхронізовані з мобільного пристрою.

Кінцева точка

Параметри запиту

Приклад запиту

Приклад JSON-відповіді

{ "success": true, "apikey": "YOUR_API_KEY_HASH", "limit": 50, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": null }, "count": 3, "rows": [ { "phone_number": "+15551230010", "cached_name": "Джордан Блейк", "call_date_ms": 1774027779390, "call_datetime_utc": "2026-03-20 17:29:39", "duration_sec": 23, "geo_location": "Канада", "created_at": "2026-03-20 17:46:45" }, { "phone_number": "+15551230011", "cached_name": "Морган Лі", "call_date_ms": 1774018268663, "call_datetime_utc": "2026-03-20 14:51:08", "duration_sec": 50, "geo_location": "Канада", "created_at": "2026-03-20 14:58:37" }, { "phone_number": "+447700900124", "cached_name": "Сем Паркер", "call_date_ms": 1774011205123, "call_datetime_utc": "2026-03-20 12:53:25", "duration_sec": 92, "geo_location": "Канада", "created_at": "2026-03-20 12:59:01" } ] }

Пояснення відповіді

Вихідні дзвінки – Список

Отримувати вихідні дзвінки, синхронізовані з мобільного пристрою.

Кінцева точка

Параметри запиту

Ті ж параметри та поведінка, що й для вхідних дзвінків.

Приклад запиту

Приклад JSON-відповіді

{ "success": true, "apikey": "YOUR_API_KEY_HASH", "limit": 50, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": null }, "count": 3, "rows": [ { "phone_number": "+15551230020", "cached_name": "Кейсі Морган", "call_date_ms": 1774025965645, "call_datetime_utc": "2026-03-20 16:59:25", "duration_sec": 15, "geo_location": "Канада", "created_at": "2026-03-20 17:17:58" }, { "phone_number": "+15551230021", "cached_name": "Тейлор Брукс", "call_date_ms": 1774023172638, "call_datetime_utc": "2026-03-20 16:12:52", "duration_sec": 556, "geo_location": "Канада", "created_at": "2026-03-20 16:28:38" }, { "phone_number": "+33198765432", "cached_name": "Джеймі Картер", "call_date_ms": 1774019040000, "call_datetime_utc": "2026-03-20 15:04:00", "duration_sec": 61, "geo_location": "Канада", "created_at": "2026-03-20 15:09:11" } ] }

Пояснення відповіді

Поля пропущених викликів

Поля вхідних/вихідних повідомлень