Обсуждение документации для разработчиков - SMSMobileAPI
Документация по API управления вызовами SMSMobileAPI

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

Базовый 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=1555&date_from_ms=1700000000000&date_to_ms=1700864000000

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

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

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

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

Пагинация

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

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

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

Поиск

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

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

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

Все примеры ответов в этой документации приведены ниже. анонимизированныйПриведенные ниже ключи API, номера телефонов и имена контактов являются лишь примерами значений.

Ошибки

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&offset=0&limit=100

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

{ "success": true, "offset": 0, "limit": 100, "count": 3, "data": [ { "number": "+15551230001", "name": "", "date": "2026-03-20 16:12:28" }, { "number": "+15551230002", "name": "Alex Carter", "date": "2026-03-20 16:12:00" }, { "number": "+447700900123", "name": "Taylor Reed", "date": "2026-03-20 15:48:41" } ] }

пояснение к ответу

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

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

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

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

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

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

ПараметрТипОписание
апикинитьНеобходимый Ваш API-ключ (проверяется по подписке).
лимитинтНеобязательный Количество строк на странице (по умолчанию: 50, макс. 200).
компенсироватьинтНеобязательный Смещение пагинации (по умолчанию: 0).
Сортировать понить Необязательный Допустимый: 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=50&offset=0&sort_by=call_date_ms&sort_dir=desc

Пример 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": "Jordan Blake", "call_date_ms": 1774027779390, "call_datetime_utc": "2026-03-20 17:29:39", "duration_sec": 23, "geo_location": "Canada", "created_at": "2026-03-20 17:46:45" }, { "номер_телефона": "+15551230011", "кэшированное_имя": "Морган Ли", "дата_звонка_мс": 1774018268663, "дата_звонка_время_UTC": "2026-03-20 14:51:08", "продолжительность_сек": 50, "гео_местоположение": "Канада", "создано_в": "2026-03-20 14:58:37" }, { "номер_телефона": "+447700900124", "кэшированное_имя": "Сэм Паркер", "дата_звонка_мс": 1774011205123, "дата_звонка_время_UTC": "2026-03-20 12:53:25", "продолжительность_сек": 92, "гео_местоположение": "Канада", "created_at": "2026-03-20 12:59:01" ] }

пояснение к ответу

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

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

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

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

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

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

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

ПараметрТипОписание
апикинитьНеобходимый Ваш API-ключ (проверяется по подписке).
лимитинтНеобязательный Количество строк на странице (по умолчанию: 50, макс. 200).
компенсироватьинтНеобязательный Смещение пагинации (по умолчанию: 0).
Сортировать понить Необязательный Допустимый: 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/outgoing/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc

Пример 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": "Casey Morgan", "call_date_ms": 1774025965645, "call_datetime_utc": "2026-03-20 16:59:25", "duration_sec": 15, "geo_location": "Canada", "created_at": "2026-03-20 17:17:58" }, { "phone_number": "+15551230021", "cached_name": "Taylor Brooks", "call_date_ms": 1774023172638, "call_datetime_utc": "2026-03-20 16:12:52", "duration_sec": 556, "geo_location": "Canada", "created_at": "2026-03-20 16:28:38" }, { "phone_number": "+33198765432", "cached_name": "Jamie Carter", "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" ] }

пояснение к ответу

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

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

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

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

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

Введите свой адрес электронной почты
чтобы помочь нам выполнить ваш запрос:
Панель инструментов