SMS 文档

发送短信

端点： 

参数：

例子：

重新发送未发送的短信

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

端点：

范围： 

例子： 

从 API 发送的短信日志

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

端点： 

范围：

例子：

短信已接收

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

端点：

范围： 

例子：

将收到的短信标记为已读

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

端点：

范围： 

例子：

删除短信

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

端点： 

范围：

例子：

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

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

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

端点：

参数：

例子：

网关 – 更新移动标签

更新已连接移动设备的标签（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 身份验证 为了增强安全性和可扩展性。