从这里开始
你的第一个要求,分四步走
创建一个账户,并从仪表板复制 ZQQ-8QXZ 密钥 。
安装移动应用程序,确认设备已在线.
发送一个测试短消息,其中包含/sendsms/端点.
存储返回的信件ID以链接日志和发送状态 。
官方移动应用程序
电话、仪表板和ZQQ8Z之间的安全桥
SMS and call operations pass through the official SMSMobileAPI app installed on your connected phone. The app securely pairs the device with your account, synchronizes authorized events and links the mobile network to the dashboard and REST API.
- 通过Google Play和App Store官方上市发布签名的版本
- Google和苹果平台审查、签署和发行控制
- 安全设备对接、ZQQX11XZS运输以及经认证的ZQX8ZZ接入
- 仅为您启用的移动特性所需的权限
验证
在服务器上保存证书
每个请求都通过 apikey 参数接受 ZQQ-8QXZ 键 。 ZQQQ13Z2客户端的资质也可用于服务器到服务器的集成. 永远不要在浏览器代码,公共寄存器或支持消息中暴露出一个生产密钥.
后 获得
发送短消息
https://api.smsmobileapi.com/sendsms/查询连接电话中的信息 。 POST是当消息长或包含特殊字符时被推荐的.
用于交易信件,提醒,提醒以及应用程序生成的短消息.
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | 你的账户ZQQ8Z键。 |
recipients |
电话 | 必需的 | 目的地编号,国际格式。 |
message |
细绳 | 必需的 | 消息体相. 师曰. 使用GET时, URL 编码它 。 |
port |
1 | 2 | 选修的 | SIM port on compatible Android devices; leave empty for automatic selection. |
sIdentifiant |
细绳 | 选修的 | 特定连接的电话 SID; 将第一个可用的设备留为空 。 |
shorturl |
0 | 1 | 选修的 | 设定为 1 以缩短信件中找到的 URL 。 |
sendsms |
0 | 1 | 选修的 | 短消息频道旗. 省略时默认为 1 。 |
sendwa |
0 | 1 | 选修的 | 请在账户支持时提供 ZQQ1Z。 |
encrypt_message |
是的 | 选修的 | 加密信件供收件人端保护读取 。 |
schedule_timestamp |
解开秒 | 选修的 | UTC时间,可以发送消息. |
请求示例
curl -X POST "https://api.smsmobileapi.com/sendsms/" \
-d "apikey=YOUR_API_KEY" \
-d "recipients=+1234567890" \
--data-urlencode "message=Your appointment is confirmed for tomorrow."
示例回复
{
"result": {
"error": 0,
"sent": "1",
"id": "c319d3b35e8f8712cde20dae39ac3c19f86eda25",
"note": "sent by mobile",
"datetime": "2026-03-20T21:07:44Z",
"port": null,
"send_with_whatsapp": "0"
}
}
想听这个请求吗?连接您的 ZQQ8ZZ 键在页面上方打开交互测试器 。
连接密钥 QQ- ZQQQ8QXZ响应成功意味着消息被平台接受;保留回回的ID以做后期跟踪.
- 载体的交付和移动处理可以在ZQQ11QXZ响应后发生.
后 获得
重新发送未发送的短信
https://api.smsmobileapi.com/resend/重试当前处于错误状态的信件 。
在检查发送的日志并确认一个失败的消息符合再次尝试的条件后使用此功能 。
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | 你的账户ZQQ8Z键。 |
guid |
细绳 | 必需的 | 消息 GUID 由发送或日志端点返回 。 |
请求示例
curl "https://api.smsmobileapi.com/resend/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE"
示例回复
{
"result": {
"error": "0",
"sms": "resent with successfully",
"attempt": 1
}
}
想听这个请求吗?连接您的 ZQQ8ZZ 键在页面上方打开交互测试器 。
连接密钥 QQ- 只有有错误状态的信件才能被怨恨.
得到
ZQQ8ZZ发送的邮件列表
https://api.smsmobileapi.com/log/sent/sms/返回通过 SMS ZQQ8QXZ 提交的消息,并附有队列,移动和出错信息.
用于对交付情况进行监测,支持诊断和调节。
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | 你的账户ZQQ8Z键。 |
guid_message |
细绳 | 选修的 | 以它独特的 GUID 返回一个消息 。 |
before |
timestamp or reference | 选修的 | 在提供的光标或时间戳前返回消息 。 |
error_api |
0 | 1 | 选修的 | 设定为 1 只返回 ZQQ8QXZ 处理错误 。 |
error_mobile |
0 | 1 | 选修的 | 设定为 1 只返回移动发送错误 。 |
keyword |
细绳 | 选修的 | 搜索收件人号码或信件文本 。 |
请求示例
curl "https://api.smsmobileapi.com/log/sent/sms/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"
示例回复
{
"result": {
"error": "0",
"sms": [{
"sIdentifiantPhone": "508b004b4aadacc4",
"recipients": "+1234567890",
"sms": "Test message",
"guid_message": "MESSAGE_GUID",
"send_from_mobile": 1,
"error_api": "",
"send_from_mobile_erreur": ""
}]
}
}
想听这个请求吗?连接您的 ZQQ8ZZ 键在页面上方打开交互测试器 。
连接密钥 QQ
得到
列出手机同步的短消息
https://api.smsmobileapi.com/log/sent/frommobile/列出手机发送的短信,并与平台同步.
当消息可能发自电话时以及通过ZQQ8QXZ时使用.
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | 你的账户ZQQ8Z键。 |
date |
年-月-月-月 | 选修的 | 过滤一个确切的日期。 |
date_from |
年-月-月-月 | 选修的 | Start of a date range. |
date_to |
年-月-月-月 | 选修的 | 约会范围结束 。 |
period |
语句 | 选修的 | 今天, 昨天, 24小时, 3天或7天。 |
number |
电话 | 选修的 | Filter by recipient. |
sIdentifiant |
细绳 | 选修的 | 通过连接的移动 SID 过滤 。 |
message |
细绳 | 选修的 | 以信件内容过滤 。 |
search |
细绳 | 选修的 | 全球搜索跨越移动,号码,消息和时间戳. |
sort_by |
语句 | 选修的 | sIDentifiant, 数字, 消息, 移动 日期 ms, 移动 日期 格式化或同步hro 时间 。 |
sort_order |
ASC DESC 高级高级研究中心 | 选修的 | 排序方向。 |
limit |
整数 | 选修的 | 最高200个记录。 |
请求示例
curl "https://api.smsmobileapi.com/log/sent/frommobile/?apikey=YOUR_API_KEY&period=last_7days&limit=200"
示例回复
{
"result": {
"error": "0",
"count": 1,
"history_limit_days": 7,
"sms": [{
"sIdentifiant": "508b004b4aadacc4",
"number": "+15551234567",
"message": "Appointment confirmed.",
"mobile_date_ms": 1774041004692,
"synchro_time": "2026-03-20 21:10:05"
}]
}
}
想听这个请求吗?连接您的 ZQQ8ZZ 键在页面上方打开交互测试器 。
连接密钥 QQ- Requires Android app 4.1.20 or newer and must be enabled in the app.
- 此端点返回同步历史最长为7天.
得到
收到名单短消息
https://api.smsmobileapi.com/getsms/从连接的电话返回进场的短消息同步。
使用它来构建收件箱,进行民意调查以获取回复,或在被网路中断后恢复消息.
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | 你的账户ZQQ8Z键。 |
sIdentifiantPhone |
细绳 | 选修的 | 由接收短信的电话过滤. |
after_timestamp_unix |
解开秒 | 选修的 | 返回此时间戳后收到的信息 。 |
onlyunread |
是的 | 选修的 | 返回未以 ZQQ8QZ 状态标记的信件 。 |
请求示例
curl "https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY&onlyunread=yes"
示例回复
{
"result": {
"error": "",
"sms": [{
"id": 466340,
"sIdentifiantPhone": "508b004b4aadacc4",
"timestamp_unix": 1774041814,
"message": "Please call us back.",
"number": "+15551234567",
"guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122",
"alias": null
}]
}
}
想听这个请求吗?连接您的 ZQQ8ZZ 键在页面上方打开交互测试器 。
连接密钥 QQ
后 获得
将收到的短信标为已读
https://api.smsmobileapi.com/getsms/set-read/标记一个收到消息,在SMSMobileAPI Z8QXZ状态中读取.
处理信件后使用此选项 。
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | 你的账户ZQQ8Z键。 |
guid_message |
细绳 | 必需的 | 接收到的短信的GUID. |
请求示例
curl "https://api.smsmobileapi.com/getsms/set-read/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"
想听这个请求吗?连接您的 ZQQ8ZZ 键在页面上方打开交互测试器 。
连接密钥 QQ- 这不会改变电话消息应用程序内的读取状态.
后 获得
更新收到的短消息别名
https://api.smsmobileapi.com/getsms/update/添加,更改或清除与收到的短消息相关的别名.
使用别名在信件上附加联系人名称或应用程序标签.
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | 你的账户ZQQ8Z键。 |
guid |
细绳 | 必需的 | 接收到的短信的GUID. |
alias |
细绳 | 必需的 | 新别名. 发送空值以清除它 。 |
请求示例
curl "https://api.smsmobileapi.com/getsms/update/?apikey=YOUR_API_KEY&guid=MESSAGE_GUID&alias=John%20Doe"
想听这个请求吗?连接您的 ZQQ8ZZ 键在页面上方打开交互测试器 。
连接密钥 QQ
后 获得
删除短消息服务器日志
https://api.smsmobileapi.com/deletesms/从 SMSMobileAPI 服务器日志中删除短消息记录.
用于保留工作流程或删除已登录的特定信件。
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | 你的账户ZQQ8Z键。 |
guid_message |
细绳 | 选修的 | 由 GUID 删除一条消息 。 |
date_start |
年-月-月-月 | 选修的 | 删除该日期的记录。 |
date_end |
年-月-月-月 | 选修的 | 使用日期 启动,限制删除范围。 |
请求示例
curl "https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"
示例回复
{
"result": {
"error": null,
"count_delete": 1
}
}
想听这个请求吗?连接您的 ZQQ8ZZ 键在页面上方打开交互测试器 。
连接密钥 QQ- 仅删除服务器日志条目 。 它不删除存储在移动设备上的信件.
- 将操作视为破坏性操作,并在调用前进行过滤.
得到
List SMS conversations
https://api.smsmobileapi.com/conversation/sms/list/以电话号码将信件收发到对话中。
用于聊天视图、最近的对话部件和支持时间段 。
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | 你的账户ZQQ8Z键。 |
origineConversation |
收到 发送 | 必需的 | 用于识别起始对话的数据集 。 |
numero |
电话 | 选修的 | 回到一个电话号码的对话。 |
date_from |
日期或日期 时间 | 选修的 | 开始消息范围 。 |
date_to |
日期或日期 时间 | 选修的 | 信件范围的结束 。 |
sort |
ASC DESC 高级高级研究中心 | 选修的 | 对话命令; 默认 DESC. |
limit |
整数 | 选修的 | 省略numero时的交谈限制; 默认 20。 |
resume |
0 | 1 | 选修的 | 设定为 1 只返回每个对话的最新消息 。 |
resume_line_how |
整数 | 选修的 | 每次对话时消息数=1. |
请求示例
curl "https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=received&resume=1&resume_line_how=3"
示例回复
{
"success": true,
"origineConversation": "received",
"conversations": [{
"phone_number": "+15551234567",
"contact_alias": "John Doe",
"messages": [{
"direction": "incoming",
"message_id": "msg_1001",
"timestamp_utc": "2026-03-13T08:45:12Z",
"message": "I need more information.",
"status": "received",
"mobile_sid": "device_sid_1"
}]
}]
}
想听这个请求吗?连接您的 ZQQ8ZZ 键在页面上方打开交互测试器 。
连接密钥 QQ
得到
列出已连接的移动设备
https://api.smsmobileapi.com/gateway/mobile/list/列出连接到短信网关账户的电话.
使用它来选择发送器,显示设备状态或审计网关机队.
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | 你的账户ZQQ8Z键。 |
sid |
细绳 | 选修的 | 返回一个精确的移动SID。 |
search |
细绳 | 选修的 | 搜索SID,日期,电池,版本,标签和相关字段. |
请求示例
curl "https://api.smsmobileapi.com/gateway/mobile/list/?apikey=YOUR_API_KEY"
想听这个请求吗?连接您的 ZQQ8ZZ 键在页面上方打开交互测试器 。
连接密钥 QQ
后 获得
更新一个连接的移动
https://api.smsmobileapi.com/gateway/mobile/update/更新连接设备的可读标签或电话号码。
使用它来保持设备标签在多管设备中有意义的.
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | 你的账户ZQQ8Z键。 |
sid |
细绳 | 必需的 | 设备SID. |
label |
细绳 | 必需的 | 新标签; 可能是有意的空的 。 |
phone_number |
电话 | 选修的 | 新的电话号码元数据。 |
请求示例
curl "https://api.smsmobileapi.com/gateway/mobile/update/?apikey=YOUR_API_KEY&sid=DEVICE_SID&label=OfficePhone"
想听这个请求吗?连接您的 ZQQ8ZZ 键在页面上方打开交互测试器 。
连接密钥 QQ
后 获得
删除已连接的移动设备
https://api.smsmobileapi.com/gateway/mobile/delete/删除一个连接的移动及其网关历史行。
仅在电话必须永久从账户中取出时使用.
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | 你的账户ZQQ8Z键。 |
sid |
细绳 | 必需的 | 要删除的设备的 SID 。 |
请求示例
curl "https://api.smsmobileapi.com/gateway/mobile/delete/?apikey=YOUR_API_KEY&sid=DEVICE_SID"
想听这个请求吗?连接您的 ZQQ8ZZ 键在页面上方打开交互测试器 。
连接密钥 QQ- 此操作会删除与 SID 相关的设备历史 。 呼叫前确认装置
原职
以网路标记接收短消息
Your HTTPS endpointSMSMobileAPI sends a JSON request to your configured URL whenever an SMS is received.
使用webhoks进行实时处理,而不是频繁投票.
接收者示例
<?php
$payload = json_decode(file_get_contents('php://input'), true);
if (!is_array($payload) || empty($payload['guid'])) {
http_response_code(400);
exit('Invalid payload');
}
// Queue the event, then acknowledge quickly.
http_response_code(200);
echo 'OK';
示例回复
{
"date": "2026-03-20",
"hour": "10:15:00",
"time_received": "2026-03-20 10:14:50",
"message": "Hello, this is a test.",
"number": "+123456789",
"guid": "abcde12345"
}
此端点在您自己的 ZQQ11ZS URL 接收事件 。 使用上面的接收器示例,然后发送到您连接的手机的短消息进行测试.
- 在 Dashboard 上配置公众 ZQQQ11QZS URL 。
- 快速返回 ZQQ11Z200 并同步处理事件.
- 使用guid来重复复制.
故障排除
错误和安全的重试
在重试前读取 ZQQQ11QXZ 状态和 ZQQ10QXZ 错误字段 。 不先更正请求, 不重试验证或认证失败 。
| 兹克罗兹 | 代码 | 怎么办 |
|---|---|---|
| 400 | missing_parameter | 需要的参数为空或缺失 。 请检查endpoint的参数表. |
| 403 | invalid_apikey | ZQQQ8QXZ 密钥未知, 过期或未授权用于请求的特性 。 |
| 429 | too_many_requests | 请求来得太快了 等等,然后用指数回放来重试. |
| 500 | server_error | 服务无法完成请求 。 如果持续,则保持响应和联系支持。 |
需要帮助吗?
带上请求的背景 而不是你的秘密
分享端点,时间戳,ZQQQ11QXZ状态和消毒反应. 永远不要包括 ZQQ8QZ 密钥, 令牌或私人信件内容 。


