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

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

Ці кінцеві точки дозволяють вам отримати ваші Пропущені дзвінки, Вхідні прийняті дзвінки, і Вихідні дзвінки синхронізовано з мобільного додатку SMSMobileAPI на вашу панель інструментів + API.

Важливо: якщо мобільний додаток працює у фоновому режимі, телефонна система може запровадити затримку (часто до ~10 хвилин) між синхронізаціями. Ви завжди можете відкрити додаток для синхронізації вручну, якщо це необхідно.

Підтримка: api@smsmobileapi.com

Пошук

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

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

ОТРИМАТИhttps://api.smsmobileapi.com

Усі кінцеві точки нижче задокументовані як ОТРИМАТИ запити. Замінити ВАШ_КЛЮЧ_API з вашим справжнім ключем (не поширюйте його публічно).

Приклади


ОТРИМАТИ https://api.smsmobileapi.com/call/missed/list/?apikey=ВАШ_КЛЮЧ_API


ОТРИМАТИ https://api.smsmobileapi.com/call/incoming/list/?apikey=ВАШ_КЛЮЧ_API&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc


ОТРИМАТИ https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&q=3247&date_from_ms=1700000000000&date_to_ms=1700864000000

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

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

Підтвердження підписки: Вхідні/вихідні кінцеві точки перевіряють ваш ключ API та дійсність вашої підписки (на основі dateLimit >= CURDATE()). Якщо термін дії закінчився, ви отримаєте термін дії api_expiredКінцева точка пропущених викликів може повертати загальне повідомлення «Відсутній apikey» / помилки сервера залежно від умов.

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

Пагінація

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

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

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

Пошук

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

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

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

Помилки

HTTP	Приклад помилки	Значення
400	`{"успіх":хибність,"помилка":"відсутній_ключ_апікею"}`	Відсутній або порожній `apikey`.
403	`{"успіх":хибно,"помилка":"недійсний_ключ_апікею"}`	Ключ API не знайдено / не розпізнано.
403	`{"успіх":хибно,"помилка":"термін дії api_expired"}`	Термін дії вашої підписки закінчився (`ліміт дати` це до сьогоднішнього дня).
500	`{"успіх":false,"помилка":"помилка_сервера","деталі":"..."}`	Помилка сервера (база даних, SQL, виняток).

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

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

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

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

ОТРИМАТИhttps://api.smsmobileapi.com/call/missed/list/

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

Параметр	Тип	опис
Обов'язковий`apikey`	рядок	Ваш API-ключ, прив'язаний до мобільного телефону.
Необов'язково`зміщення`	ціл.	Зсув сторінок (за замовчуванням: `0`).
Необов'язково`ліміт`	ціл.	Максимальна кількість рядків для повернення (за замовчуванням: `100`, макс.: `500`).
Необов'язково`пошук`	рядок	Пошук за номером або назвою (SQL LIKE).
Необов'язково`дата_початку`	РРРР-ММ-ДД	Фільтр з цього дня (00:00:00). Порівнюється зі збереженою міткою часу в мілісекундах.
Необов'язково`дата_кінця`	РРРР-ММ-ДД	Фільтрувати до цього дня (23:59:59). Порівнювати зі збереженою міткою часу в мілісекундах.

Сортування

Виправлено: спочатку найновіші (СОРТИРОВАТИ ЗА ДАТОЮ ЗА СПИСКОМ).

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


ОТРИМАТИ https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY&limit=100&offset=0&search=John&date_start=2026-02-01&date_end=2026-02-24

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

{ "success": true, "offset": 0, "limit": 100, "count": 2, "data": [ { "number": "+123470000000", "name": "Іван", "date": "2026-02-24 12:49:39" }, { "number": "+123471111111", "name": "", "date": "2026-02-24 11:12:09" } ] }

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

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

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

ОТРИМАТИhttps://api.smsmobileapi.com/call/incoming/list/

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

Параметр	Тип	опис
Обов'язковий`apikey`	рядок	Ваш ключ API. Перевірено за підпискою (`ліміт дати`).
Необов'язково`ліміт`	ціл.	Рядків на сторінці (за замовчуванням: `50`, мін. 1, макс. `200`).
Необов'язково`зміщення`	ціл.	Зсув сторінок (за замовчуванням: `0`).
Необов'язково`сортувати_за`	рядок	Поле сортування (за замовчуванням: `дата_дзвінка_мс`). Дозволено: `дата_дзвінка_мс`, `дата_час_дзвінка UTC`, `тривалість_сек`, `номер_телефону`, `створено_за_адресою`, `кешована_ім'я`, `геолокація`.
Необов'язково`каталог_сортування`	зростання\|спадання	Напрямок сортування (за замовчуванням: `опис`).
Необов'язково`дата_від_мс`	ціле (мс)	Фільтрувати, де `дата_дзвінка_мс >= дата_від_мс`.
Необов'язково`дата_до_мс`	ціле (мс)	Фільтрувати, де `дата_дзвінка_мс <= дата_до_мс`.
Необов'язково`q`	рядок	Пошук (ПОДІБНО) на `номер_телефону` або `кешована_ім'я`.

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


ОТРИМАТИ https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=100&offset=0&sort_by=call_date_ms&sort_dir=desc&q=3247

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

{ "success": true, "apikey": "ВАШ_КЛЮЧ_API", "limit": 100, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": "+12347" }, "count": 2, "rows": [ { "phone_number": "+123470000000", "cached_name": "Маттео Css", "call_date_ms": 1761233379000, "call_datetime_utc": "2026-02-23 12:49:39", "duration_sec": 440, "geo_location": "Бельгія", "created_at": "2026-02-24 04:14:38" } ] }

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

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

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

ОТРИМАТИhttps://api.smsmobileapi.com/call/outgoing/list/

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

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

Параметр	Тип	опис
Обов'язковий`apikey`	рядок	Ваш ключ API. Перевірено за підпискою (`ліміт дати`).
Необов'язково`ліміт`	ціл.	Рядків на сторінці (за замовчуванням: `50`, макс. `200`).
Необов'язково`зміщення`	ціл.	Зсув сторінок (за замовчуванням: `0`).
Необов'язково`сортувати_за`	рядок	За замовчуванням `дата_дзвінка_мс`Дозволено: `дата_дзвінка_мс`, `дата_час_дзвінка UTC`, `тривалість_сек`, `номер_телефону`, `створено_за_адресою`, `кешована_ім'я`, `геолокація`.
Необов'язково`каталог_сортування`	зростання\|спадання	За замовчуванням `опис`.
Необов'язково`дата_від_мс`	ціле (мс)	Фільтрувати за цією позначкою часу (мс).
Необов'язково`дата_до_мс`	ціле (мс)	Фільтрувати до цієї позначки часу (мс).
Необов'язково`q`	рядок	Пошук на `номер_телефону` або `кешована_ім'я`.

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


ОТРИМАТИ https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=duration_sec&sort_dir=desc&date_from_ms=1700000000000&date_to_ms=1700864000000

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

{ "success": true, "apikey": "ВАШ_КЛЮЧ_API", "limit": 50, "offset": 0, "sort_by": "duration_sec", "sort_dir": "desc", "filters": { "date_from_ms": "1700000000000", "date_to_ms": "1700864000000", "q": null }, "count": 1, "rows": [ { "phone_number": "+123490000000", "cached_name": null, "call_date_ms": 1761231000000, "call_datetime_utc": "2026-02-23 12:10:00", "duration_sec": 120, "geo_location": "Бельгія", "створено_в": "2026-02-24 04:14:37" } ] }

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

Поле	Тип	опис
`успіх`	логічна змінна	Запит статусу.
`зміщення`	ціл.	Повернуто зміщення пагінації.
`ліміт`	ціл.	Повернуто обмеження на пагінацію.
`рахувати`	ціл.	Кількість рядків, що повертаються в `дані`.
`дані`	масив	Список пропущених дзвінків.
`дані[].число`	рядок	Номер телефону абонента.
`дані[].назва`	рядок	Кешоване ім'я контакту (може бути порожнім).
`дані[].дата`	рядок	Відформатований рядок дати та часу, отриманий з позначки часу в мілісекундах.

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

Поле	Тип	опис
`успіх`	логічна змінна	Запит статусу.
`apikey`	рядок	Відповідь від API (ваш ключ).
`ліміт`	ціл.	Повернуто рядків на сторінці.
`зміщення`	ціл.	Повернуто зміщення пагінації.
`сортувати_за`	рядок	Застосоване поле сортування.
`каталог_сортування`	рядок	Застосовано напрямок сортування.
`фільтри`	об'єкт	Відлуння фільтрів (`дата_від_мс`, `дата_до_мс`, `q`).
`рахувати`	ціл.	Кількість рядків, що повертаються в `рядки`.
`рядки`	масив	Список дзвінків.
`рядки[].номер_телефону`	рядок	Номер телефону.
`рядки[].кешована_ім'я`	рядок\|нуль	Кешоване ім'я контакту (може бути null).
`рядки[].call_date_ms`	ціл.	Мітка часу виклику в мілісекундах.
`рядки[].call_datetime_utc`	рядок	Поле дати та часу UTC (база даних).
`рядки[].duration_sec`	ціл.	Тривалість у секундах.
`рядки[].геолокація`	рядок\|нуль	Мітка геолокації (може бути null/порожньою).
`рядки[].created_at`	рядок	Мітка часу вставки на сервер.

API та документи для розробників

Інструменти та журнал змін

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

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

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

Приклади

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

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

Пагінація

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

Пошук

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

Помилки

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

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

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

Сортування

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

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

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

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

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

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

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

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

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

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

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

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

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

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

💬 Доступний живий чат