Документация по API управления вызовами SMSMobileAPI

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

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

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

Поддерживать: api@smsmobileapi.com

Поиск

Быстрый старт

Базовый URL

ПОЛУЧАТЬhttps://api.smsmobileapi.com

Все указанные ниже конечные точки задокументированы как ПОЛУЧАТЬ запросы. Заменить YOUR_API_KEY Используйте свой настоящий ключ (не сообщайте его публично).

Примеры


Получите https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY


Получите https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&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

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

Устройства управления вызовами проходят аутентификацию с использованием апики параметр запроса.

Подтверждение подписки: Входящие/исходящие конечные точки проверяют ваш API-ключ и срок действия вашей подписки (на основе...). dateLimit >= CURDATE()Если срок действия истек, вы получите api_expiredВ зависимости от условий, конечная точка для пропущенных вызовов может возвращать стандартное сообщение об ошибке «Отсутствует ключ API» / ошибку сервера.

Общие понятия

Пагинация

Использовать лимит и компенсировать для постраничного отображения результатов.

Временные метки

call_date_ms представляет собой метку времени UNIX в миллисекунды.
call_datetime_utc хранится в виде строки даты и времени в формате UTC (поле базы данных).
В случае пропущенных звонков API возвращает отформатированный результат. дата строка (полученная из значения в миллисекундах).

Поиск

Пропущенные звонки: поиск Соответствует номеру или имени.
Входящие/Исходящие: q соответствует номеру телефона или кэшированному имени.

Сортировка (только входящие/исходящие)

Сортировка контролируется Сортировать по + сортировка_директории (Только поля из белого списка). Пропущенные звонки всегда сортируются по дате, начиная с самых новых.

Ошибки

HTTP	Пример ошибки	Значение
400	`{"success":false,"error":"missing_apikey"}`	Отсутствует или пусто `апики`.
403	`{"success":false,"error":"invalid_apikey"}`	Ключ API не найден / не распознан.
403	`{"success":false,"error":"api_expired"}`	Срок действия вашей подписки истек (`dateLimit` это было до сегодняшнего дня).
500	`{"success":false,"error":"server_error","detail":".."}`	Ошибка сервера (база данных, SQL, исключение).

Примечание: конечная точка «Пропущенные звонки» также может возвращать сообщения, подобные следующим: Отсутствует апикей или ошибки при подготовке SQL-запроса, в зависимости от ситуации.

Список пропущенных звонков

Восстановите пропущенные звонки, синхронизированные с мобильного устройства.

Конечная точка

ПОЛУЧАТЬhttps://api.smsmobileapi.com/call/missed/list/

Параметры запроса

Параметр	Тип	Описание
Необходимый`апики`	нить	Ваш 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": "John Doe", "date": "2026-02-24 12:49:39" }, { "number": "+123471111111", "name": "", "date": "2026-02-24 11:12:09" } ] }

Список входящих звонков

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

Конечная точка

ПОЛУЧАТЬhttps://api.smsmobileapi.com/call/incoming/list/

Параметры запроса

Параметр	Тип	Описание
Необходимый`апики`	нить	Ваш API-ключ. Проверено по подписке (`dateLimit`).
Необязательный`лимит`	инт	Количество строк на странице (по умолчанию: `50`мин. 1, макс. `200`).
Необязательный`компенсировать`	инт	Смещение пагинации (по умолчанию: `0`).
Необязательный`Сортировать по`	нить	Поле сортировки (по умолчанию: `call_date_ms`). Допустимый: `call_date_ms`, `call_datetime_utc`, `длительность_сек`, `номер телефона`, `created_at`, `cached_name`, `геолокация`.
Необязательный`сортировка_директории`	восхождение\|нисхождение	Направление сортировки (по умолчанию: `описание`).
Необязательный`дата_из_мс`	целочисленный (мс)	Фильтр по `call_date_ms >= date_from_ms`.
Необязательный`дата_в_мс`	целочисленный (мс)	Фильтр по `call_date_ms <= date_to_ms`.
Необязательный`q`	нить	Ищите (Нравится) на `номер телефона` или `cached_name`.

Пример запроса


Получите 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": "Matteo Css", "call_date_ms": 1761233379000, "call_datetime_utc": "2026-02-23 12:49:39", "duration_sec": 440, "geo_location": "Belgique", "created_at": "2026-02-24 04:14:38" } ] }

Список исходящих звонков

Восстанавливайте исходящие вызовы, синхронизированные с мобильного устройства.

Конечная точка

ПОЛУЧАТЬhttps://api.smsmobileapi.com/call/outgoing/list/

Параметры запроса

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

Параметр	Тип	Описание
Необходимый`апики`	нить	Ваш API-ключ. Проверено по подписке (`dateLimit`).
Необязательный`лимит`	инт	Количество строк на странице (по умолчанию: `50`, макс. `200`).
Необязательный`компенсировать`	инт	Смещение пагинации (по умолчанию: `0`).
Необязательный`Сортировать по`	нить	По умолчанию `call_date_ms`. Допустимый: `call_date_ms`, `call_datetime_utc`, `длительность_сек`, `номер телефона`, `created_at`, `cached_name`, `геолокация`.
Необязательный`сортировка_директории`	восхождение\|нисхождение	По умолчанию `описание`.
Необязательный`дата_из_мс`	целочисленный (мс)	Фильтр по этой временной метке (мс).
Необязательный`дата_в_мс`	целочисленный (мс)	Фильтрация по этой временной метке (мс).
Необязательный`q`	нить	Поиск по `номер телефона` или `cached_name`.

Пример запроса


GET 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": "Belgique", "created_at": "2026-02-24 04:14:37" ] }

Поля пропущенных звонков

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

Поля входящих/исходящих данных

Поле	Тип	Описание
`успех`	буль	Статус запроса.
`апики`	нить	Получено подтверждение от API (ваш ключ).
`лимит`	инт	Количество строк на странице.
`компенсировать`	инт	Возвращено смещение при постраничной навигации.
`Сортировать по`	нить	Применено поле сортировки.
`сортировка_директории`	нить	Применено направление сортировки.
`фильтры`	объект	Эхо-фильтры (`дата_из_мс`, `дата_в_мс`, `q`).
`считать`	инт	Количество строк, возвращенных в `ряды`.
`ряды`	множество	Список звонков.
`строк[].номер_телефона`	нить	Номер телефона.
`строк[].cached_name`	строка\|нулевой	Кэшированное имя контакта (может быть пустым).
`строк[].call_date_ms`	инт	Отметка времени вызова в миллисекундах.
`строк[].call_datetime_utc`	нить	Поле даты и времени в формате UTC (база данных).
`строк[].duration_sec`	инт	Продолжительность в секундах.
`строк[].гео_локация`	строка\|нулевой	Метка географического местоположения (может быть пустой).
`строк[].created_at`	нить	Отметка времени вставки на сервер.

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

Журнал инструментов и изменений

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

Быстрый старт

Базовый URL

Примеры

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

Общие понятия

Пагинация

Временные метки

Поиск

Сортировка (только входящие/исходящие)

Ошибки

Список пропущенных звонков

Конечная точка

Параметры запроса

Сортировка

Пример запроса

Пример ответа

Список входящих звонков

Конечная точка

Параметры запроса

Пример запроса

Пример ответа

Список исходящих звонков

Конечная точка

Параметры запроса

Пример запроса

Пример ответа

Поля пропущенных звонков

Поля входящих/исходящих данных

💬 Доступен онлайн-чат