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

呼叫管理 API 文档

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

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

需要帮助吗？ api@smsmobileapi.com

快速入门

基本 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=1555&date_from_ms=1700000000000&date_to_ms=1700864000000

验证

呼叫管理端点使用以下方式进行身份验证 apikey 查询参数。

订阅验证： 传入/传出端点会验证您的 API 密钥并检查您的订阅有效性（dateLimit >= CURDATE()如果过期，您将收到 api_expired.

共同概念

分页

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

时间戳

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

搜索

  • 未接来电： 搜索 匹配号码或名称。
  • 收发： q 比赛 电话号码 或者 缓存名称.

排序（仅限收件/发件）

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

本文档中的所有响应示例均为 匿名化下面显示的 API 密钥、电话号码和联系人姓名仅为示例值。

错误

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

查询参数

范围类型描述
apikey细绳必需的 您的 API 密钥（已通过订阅验证）。
限制整数选修的 每页行数（默认值：） 50， 最大限度： 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=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" }, { "phone_number": "+15551230011", "cached_name": "Morgan Lee", "call_date_ms": 1774018268663, "call_datetime_utc": "2026-03-20 14:51:08", "duration_sec": 50, "geo_location": "Canada", "created_at": "2026-03-20 14:58:37" }, { "phone_number": "+447700900124", "cached_name": "Sam Parker", "call_date_ms": 1774011205123, "call_datetime_utc": "2026-03-20 12:53:25", "duration_sec": 92, "geo_location": "Canada", "created_at": "2026-03-20 12:59:01" } ] }

回答解释

场地描述
成功真的 表示请求已成功处理。
apikey已回显的 API 密钥值。在文档示例中，此值应始终进行掩码处理。
限制每页请求的行数。
抵消API 返回的分页偏移量。
排序方式API应用的排序字段。
排序目录API 设置的排序方向。
过滤器包含请求中使用的活动过滤器的对象。
数数返回的行数 行.
行包含已接听来电记录的数组。
rows[].phone_number与通话关联的电话号码。
rows[].cached_name已缓存的联系人姓名。根据可用数据，可能为空或为 null。
rows[].call_date_ms调用时间戳（以毫秒为单位）。
rows[].call_datetime_utc通话的UTC日期和时间。
rows[].duration_sec通话时长（秒）。
rows[].geo_location如有，则显示与该编号关联的地理标签。
rows[].created_at服务器上插入该行的日期和时间。
API 可以回显你的 apikey 在回复中。在公开文档、屏幕截图和示例中，务必将其屏蔽。

拨出电话 - 列表

从移动设备检索已同步的拨出电话。

端点

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

查询参数

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

范围类型描述
apikey细绳必需的 您的 API 密钥（已通过订阅验证）。
限制整数选修的 每页行数（默认值：） 50， 最大限度： 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/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": "Canada", "created_at": "2026-03-20 15:09:11" } ] }

回答解释

场地描述
成功真的 表示请求已成功处理。
apikey已回显的 API 密钥值。在文档示例中，此值应始终进行掩码处理。
限制每页请求的行数。
抵消API 返回的分页偏移量。
排序方式API应用的排序字段。
排序目录API 设置的排序方向。
过滤器包含请求中使用的活动过滤器的对象。
数数返回的行数 行.
行包含呼出电话记录的数组。
rows[].phone_number与通话关联的电话号码。
rows[].cached_name已缓存的联系人姓名。根据可用数据，可能为空或为 null。
rows[].call_date_ms调用时间戳（以毫秒为单位）。
rows[].call_datetime_utc通话的UTC日期和时间。
rows[].duration_sec通话时长（秒）。
rows[].geo_location如有，则显示与该编号关联的地理标签。
rows[].created_at服务器上插入该行的日期和时间。
以上示例值已匿名化处理。请仅在私有/内部工具中将其替换为您自己的真实数据，切勿在公开文档中使用。

未接来电字段

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

收发字段

场地类型描述
成功布尔值请求状态。
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细绳服务器插入时间戳。
需要帮助吗？ 接触 api@smsmobileapi.com
提示：切勿在屏幕截图、工单或公共存储库中发布您的 API 密钥。
💬 实时聊天
💬 提供实时聊天
有任何问题或需要帮助吗？
我们的团队随时为您提供帮助！
输入您的电子邮件地址
帮助我们跟进您的请求：
仪表板