呼叫管理 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 | 细绳 | 服务器插入时间戳。 |
