SMS 文档

发送短信

端点： 

参数：

例子：

重新发送未发送的短信

此 API 端点用于重新发送未发送的短信（仅当消息状态为错误时）。

端点：

范围： 

例子： 

从 API 发送的短信日志

此 API 端点用于检索通过 API 发送的 SMS 消息的日志。

端点： 

范围：

例子：

列出手机发送的短信

此 API 端点用于列出从您的移动设备发送并同步到您的 SMSMobileAPI 帐户的短信。

重要的： 此功能从 Android 版本开始可用 4.1.20.

重要的： 此功能是 默认情况下未启用 在安卓应用中。

隐私： 所有同步信息均已匿名化、保密，并以安全方式处理。

历史记录限制： 此 API 始终返回上一次的数据。 7天 仅有的。

笔记： 如果您使用标准 API 端点发送短信 https://api.smsmobileapi.com/sendsms/这些短信也可能出现在此列表中，因为它们实际上是从您的移动设备发送的。

端点：

参数： 

返回的字段： 

例子： 

使用过滤器的示例：

预设周期示例：

短信已接收

此 API 端点用于检索智能手机上收到的短信。 

端点：

范围： 

例子：

将收到的短信标记为已读

此 API 端点用于将收到的短信标记为已读。 仅限 API 状态.
这不会改变智能手机上的已读状态。  

端点：

范围： 

例子：

更新短信别名

此 API 端点用于使用 GUID 更新接收到的短信的别名。

笔记： 这 alias 参数可以为空。在这种情况下，别名将被清除。

端点：

参数： 

例子： 

清除别名的示例：

删除短信

此 API 端点用于从 SMS Mobile API 的服务器日志中删除短信。

端点： 

范围：

例子：

注意：已删除的短信仅指存储在服务器日志中的短信。设备上的短信不会被删除。

列出短信对话

此 API 端点用于列出与您的帐户关联的短信对话。

每个对话都按电话号码分组，并包含相关的收发短信。

笔记： 对话的起点由以下因素决定： origineConversation 范围：

• received首先从接收到的短信中检测对话。 logsmsreceive
• sent首先从已发送的短信中检测到对话。 logsmssent

笔记： 如果 numero 如果未提供，API 仅返回最新对话。默认情况下，最后 20 对话得到回复。

笔记： 对于外发短信，如果 timearea_of_message 可用（例如： UTC+02），显示的日期将使用此值自动转换。转换后的日期也用于排序。

笔记： 如果 resume=1仅返回每个对话的最新消息。使用 resume_line_how 确定应包含多少条最新消息。

端点：

参数： 

行为详情： 

示例 1 - 列出已接收短信中的最新对话： 

示例 2 - 列出已发送短信中的最新对话：

示例 3 - 筛选特定电话号码：

示例 4 - 按日期范围筛选：

示例 5 - 恢复模式，显示每个对话的最后 3 条消息：

成功响应示例： 

{ "success": true, "origineConversation": "received", "resume": 0, "resume_line_how": null, "conversations": [ { "phone_number": "+10470000001", "contact_alias": "John Doe", "messages": [ { "direction": "incoming", "message_id": "msg_1001", "date": "2026-03-13 08:45:12", "timestamp_utc": "2026-03-13T08:45:12Z", "message": "您好，我需要更多信息。", "status": "received", "mobile_sid": "device_sid_1" }, { "direction": "outgoing", "message_id": "msg_1002", "date": "2026-03-13 10:46:03", "timestamp_utc": "2026-03-13T08:46:03Z", "message": "当然，您想知道什么？", "status": "已发送", "mobile_sid": "device_sid_2" } ] } ] }

响应字段：

错误示例：

{ "success": false, "error": "缺少必需参数：apikey" }

笔记：

网关 – 列出已连接的移动设备。

列出连接到您的设备的手机 短信网关.

端点：

参数：

例子：

网关 – 更新移动标签

更新已连接移动设备的标签（nom_reference）。

端点：

参数：

例子：

重要的： 标签为必填项，但可以为空。 （标签=）。

网关 – 删除已连接的移动设备

从网关中移除已连接的移动设备（删除此 SID 的所有历史记录行）。

端点：

参数：

例子：

Webhook – 短信已接收

此 webhook 系统每次收到短信时都会向配置的 URL 发送 POST 请求。系统通过将短信详细信息发送到指定的 webhook URL 来确保实时更新。

如何在仪表板中配置 Webhook

按照以下步骤在仪表板中设置您的 webhook URL：

1. 登录您的账户 SMS 移动 API 仪表板.
2. 导航至 Webhook 设置 部分。
3. 输入你的 webhook URL（例如， https://example.com/webhook-endpoint).
4. 点击 保存 Webhook 按钮。 
5. 保存后，系统将开始向配置的 URL 发送短信详细信息。

Webhook 负载

收到短信时，系统会将以下 JSON 负载发送到您的 webhook URL：

{ "date": "2025-01-20", "hour": "10:15:00", "time_received": "2025-01-20 10:14:50", "message": "你好，这是个测试。", "number": "+123456789", "guid": "abcde12345" }

有效载荷字段：

• 日期： 添加短信的日期（YYYY-MM-DD）。
• 小时： 添加短信的小时（HH:mm:ss）。
• 接收时间： 短信收到时间。
• 信息： 短信内容。 
• 数字： 发件人的电话号码。
• 指南： 短信的唯一标识符。

Webhook 端点示例

您的服务器应已准备好处理传入的 POST 请求。以下是用于处理 webhook 负载的示例 PHP 脚本：

测试 Webhook

要测试你的 webhook 配置，请使用以下工具：

• Webhook.site
• 请求箱

故障排除

• 确保 webhook URL 正确且可公开访问。
• 验证您的服务器是否在成功请求时返回 HTTP 200 状态代码。
• 检查您的服务器日志，查找处理有效负载时出现的任何错误。

增强型短信

验证

SMSMobile API 支持两种身份验证方法：使用简单的 API 密钥或带有客户端 ID 和客户端密钥的 OAuth2 协议。

1. API 密钥认证

 此方法需要一个 API 密钥，该密钥可以作为参数包含在 GET 或 POST 请求中。

2. OAuth2 身份验证

OAuth2 提供了一种更安全的身份验证方法。
使用客户端 ID 和客户端密钥获取访问令牌，然后将其包含在内 授权 標軸。

client_id 和 client_secret 在您的仪表板中可用。
立即下载移动应用程序 或者 访问您的仪表板.

获取访问令牌

使用访问令牌：

您应该使用哪种方法？

- 使用 API 密钥认证 实现快速、直接的集成。

- 使用 OAuth2 身份验证 为了增强安全性和可扩展性。