文档开发调用 - SMSMobileAPI
SMSMobileAPI – 呼叫管理 API 文档

呼叫管理 API 文档

这些端点允许您检索您的 未接来电, 已接听来电, 和 拨出电话 从 SMSMobileAPI 移动应用同步到您的仪表板 + API。

重要提示:如果移动应用在后台运行,手机系统可能会在同步之间设置延迟(通常最多约 10 分钟)。如有需要,您可以随时打开应用手动同步。

快速入门

基本 URL

得到https://api.smsmobileapi.com
以下所有端点均已记录为 得到 请求。替换 您的 API 密钥 使用您的真实密钥(请勿公开分享)。

示例

GET https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY GET https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc GET 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. 未接来电端点可能会根据具体情况返回通用的“缺少 API 密钥”/服务器错误。

共同概念

分页

使用 限制抵消 对结果进行分页显示。

时间戳

  • 通话日期(毫秒) 是 UNIX 时间戳 毫秒.
  • 调用日期时间_UTC 存储为 UTC 日期时间字符串(数据库字段)。
  • 对于未接来电,API 返回格式化的 日期 字符串(由毫秒值派生而来)。

搜索

  • 未接来电: 搜索 匹配号码或名称。
  • 收发: q 匹配电话号码或缓存名称。

排序(仅限收件/发件)

排序由……控制 排序方式 + 排序目录 (仅限白名单字段)。未接来电始终按最新排序。

错误

HTTP 示例错误 意义
400 {"成功":false,"错误":"缺少 API 密钥"} 缺失或为空 apikey.
403 {"成功":false,"错误":"无效的apikey"} 未找到/无法识别API密钥。
403 {"成功":false,"错误":"api_expired"} 您的订阅已过期(日期限制 (指今天之前)。
500 {"成功":false,"错误":"服务器错误","详情":"..."} 服务器错误(数据库、SQL、异常)。

注意:未接来电端点还可以返回类似这样的消息 缺少 API 密钥 或者,根据具体情况,可能是 SQL 准备错误。

未接来电列表

从移动设备中检索已同步的未接来电。

端点

得到https://api.smsmobileapi.com/call/missed/list/

查询参数

范围类型描述
必需的apikey 细绳 您的API密钥已绑定到手机。
选修的抵消 整数 分页偏移量(默认值:) 0).
选修的限制 整数 返回的最大行数(默认值: 100, 最大限度: 500).
选修的搜索 细绳 按编号或名称搜索(SQL LIKE)。
选修的开始日期 YYYY-MM-DD 筛选出当天(00:00:00)的数据。与存储的毫秒时间戳进行比较。
选修的日期结束 YYYY-MM-DD 筛选至当日(23:59:59)。与存储的毫秒时间戳进行比较。

排序

已修复:最新优先(按日期降序排列).

示例请求

GET 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/

查询参数

范围类型描述
必需的apikey 细绳 您的 API 密钥。已根据订阅进行验证(日期限制).
选修的限制 整数 每页行数(默认值:) 50最小值为 1,最大值为 200).
选修的抵消 整数 分页偏移量(默认值:) 0).
选修的排序方式 细绳 排序字段(默认值:) 通话日期(毫秒)允许: 通话日期(毫秒), 调用日期时间_UTC, duration_sec, 电话号码, 创建于, 缓存名称, 地理位置.
选修的排序目录 升序|降序 排序方向(默认: 描述).
选修的date_from_ms 整数(毫秒) 筛选条件 call_date_ms >= date_from_ms.
选修的日期到毫秒 整数(毫秒) 筛选条件 call_date_ms <= date_to_ms.
选修的q 细绳 搜索(点赞) 电话号码 或者 缓存名称.

示例请求

GET 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": "YOUR_API_KEY", "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/

查询参数

与来电相同的参数和行为。

范围类型描述
必需的apikey 细绳 您的 API 密钥。已根据订阅进行验证(日期限制).
选修的限制 整数 每页行数(默认值:) 50, 最大限度 200).
选修的抵消 整数 分页偏移量(默认值:) 0).
选修的排序方式 细绳 默认 通话日期(毫秒)允许: 通话日期(毫秒), 调用日期时间_UTC, duration_sec, 电话号码, 创建于, 缓存名称, 地理位置.
选修的排序目录 升序|降序 默认 描述.
选修的date_from_ms 整数(毫秒) 从此时间戳(毫秒)进行筛选。
选修的日期到毫秒 整数(毫秒) 筛选至此时间戳(毫秒)。
选修的q 细绳 搜索 电话号码 或者 缓存名称.

示例请求

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": "YOUR_API_KEY", "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" } ] }

未接来电字段

场地类型描述
成功布尔值请求状态。
抵消整数返回分页偏移量。
限制整数返回分页限制。
数数整数返回的行数 数据.
数据大批未接来电列表。
数据[].数字细绳来电电话号码。
数据[].名称细绳缓存的联系人姓名(可能为空)。
数据[].日期细绳从毫秒时间戳导出的格式化日期时间字符串。

收发字段

场地类型描述
成功布尔值请求状态。
apikey细绳API 返回(您的密钥)。
限制整数每页返回的行数。
抵消整数返回分页偏移量。
排序方式细绳应用排序字段。
排序目录细绳应用排序方向。
过滤器目的回声滤波器(date_from_ms, 日期到毫秒, q).
数数整数返回的行数 .
大批通话记录。
rows[].phone_number细绳电话号码。
rows[].cached_name字符串|null缓存的联系人姓名(可以为空)。
rows[].call_date_ms整数调用时间戳(以毫秒为单位)。
rows[].call_datetime_utc细绳UTC 日期时间字段(数据库)。
rows[].duration_sec整数持续时间(秒)。
rows[].geo_location字符串|null地理位置标签(可以为空)。
rows[].created_at细绳服务器插入时间戳。
💬 实时聊天
💬 提供实时聊天
有任何问题或需要帮助吗?
我们的团队随时为您提供帮助!

输入您的电子邮件地址
帮助我们跟进您的请求:
仪表板