短信从您自己的手机发出。了解工作原理
石窟画API 第一种架构安全设备配对交付可见度多设备控制已版本文件
开发者枢纽/兹克萨斯州

SMS · 16 已提供文档的接口操作

短消息 API 文档

发送并接收短信,检查发送日志,构建对话并管理连接的移动网关.

连接到短信和云网关基础设施的智能手机
REST 基础 URLhttps://api.smsmobileapi.com

· ZXX-10Z 答复 · ZX-11XZS 需要 · UTF-8

连接您的 API 密钥

连接一次,然后测试端点跨越短消息,电话,通知,WhatsApp和电子邮件.

从这里开始

你的第一个要求,分四步走

1

创建账户并从仪表板上复制 API 密钥 。

2

安装移动应用程序,确认设备已在线.

3

发送一个测试短消息,其中包含/sendsms/端点.

4

存储返回的信件ID以链接日志和发送状态 。

安全无虞SMSMobileAPI移动应用程序连接手机到网络仪表板和REST API,用于短信和呼叫操作
加密的移动到平台连接

官方移动应用程序

电话、仪表板和API之间的安全桥

短信和呼叫业务通过官员SMSMobileAPI应用程序安装在您的连接电话上 。 应用软件安全地将设备与您的账户对齐,同步了授权的事件,并将移动网络连接到仪表板和REST API.

1移动应用程序给手机和它的SIM配对 2加密链接认证和保护过境数据 3发牌机和 API控制工作流程和活动
  • 通过Google Play和App Store官方上市发布签名的版本
  • Google和苹果平台审查、签署和发行控制
  • 安全设备对接、HTTPS运输和认证的API访问
  • 仅为您启用的移动特性所需的权限
找官来SMSMobileAPI应用程序在Google Play 下载苹果App Store上的官方SMSMobileAPI应用
能力取决于Android或iOS允许的权限和背景访问.

此 API 的 WEBHOOK V2

仅订阅您的工作流所需的移动事件。

5 种事件类型

一个目标可以接收全部事件,或者您可以将生产系统、分析和运维告警分开。每个事件都有精确的名称,使您的应用能够可预测地处理它们。

sms.api.submitted

通过 API 提交的 SMS

一个 API 请求创建了一个 SMS 发送任务。可用于确认该请求已进入平台。

sms.sent

SMS 已发送

连接的移动设备确认了 SMS 的发送操作。

sms.failed

SMS 发送失败

已连接的手机返回了一个 SMS 发送错误。

sms.received

SMS 已接收

已连接的手机同步了一个接收的 SMS。

sms.mobile.sent

从手机发送的 SMS

已连接的手机手动发送了一个 SMS。

验证

在服务器上保存证书

每个请求都通过apikey参数接受一个API密钥. OAuth2客户端的资质也可用于服务器到服务器的集成. 永远不要在浏览器代码,公共寄存器或支持消息中暴露出一个生产密钥.

历史管理

安全清除历史: 预览、 删除、 跟踪进度

这些端点清除您所选服务器历史 API 键,而不是电话或外部服务中的信息。 它们不能提供账号的去除。 新的活性可以在删除后出现.

读取 request_id 和重试指南
保护已连接的外部集成

默认情况下,链接或处理记录仍然可见. 只使用 include_linked=1 或正在处理的软件。

怎样 request_id 工作内容

  1. 预览计数方式 action=preview。无 request_id 需要删除任何记录。
  2. 生成一个独特的 request_id 用于删除新内容,例如a UUID。发送前保存它 action=delete. . . . . . . . . . . .
  3. 重复、超时或 HTTP 202,再利用相同 API 键,历史终点, request_id 财务报告和已审计财务报表 include_linked 值。 错误发生后, 绝不自动生成新的 ID 。
  4. 何时 completed=true,操作结束。 重用其ID返回的相同结果,而不是删除新到的记录. 仅为有意进行新清理而使用新ID.

request_id 识别您的删除操作, 而不是个人 SMS允许的格式:16-128 ASCII 字母、数字、连字符或下划线。 A. 国家 UUID 用 Crypto.randomUUID () 生成是合适的。

删除按批次执行。如果返回 HTTP 202 且 continue_required=true,请在 3 秒后再次请求 action=delete。没有后台 cron 任务。action=status 只读取进度,不会继续删除,即使返回 HTTP 200 也是如此。

删除和查询状态的示例

替换样本 request_id 开始前,有你独特的价值。 以下删除请求更改真实账户历史; 它们不是预览 。

POST · 妇女 API 键
curl -X POST "https://api.smsmobileapi.com/delete-history-sms-api/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
POST · 妇女 OAuth2
curl -X POST "https://api.smsmobileapi.com/delete-history-sms-api/" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
GET 现状
curl -G "https://api.smsmobileapi.com/delete-history-sms-api/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=status" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

GET 也接受 action=preview 或 或 双 action=delete. . . . . . . . . . . . POST 建议: URL参数可以被泄露到浏览器历史和服务器日志中. 永远不要将删除的 URL 放在公共链接, 图像或预选中 。

用于 POST,以窗体或一个格式发送所有参数 JSON 对象,从查询字符串中选择。 未知参数被拒绝;日期或移动过滤器不支持.

历史记录接口的身份验证

使用 apikey 或 一种 Authorization: 调取 Bearer 由 SMSMobileAPI OAuth2。不要发送刷新符号或 API 键为 a Bearer 符号。 过期的代币被拒绝.

瞄准镜设定完毕后 history:read 允许预览/状态和 history:delete 也允许删除。 对象征和 OAuth 客户端申请。 遗物无范围可查保留其现有的账户访问权.

OAuth2 选择唯一的主机 API 键。 如果存在几个主密钥,则还提供 apikey 以选择账户所属的账户。 次要钥匙从来不允许访问主要钥匙历史。

继续操作之前请先检查响应

count_delete 是该操作所删除的累积数。 selected_at_start 是初始选择; protected_at_start 记录不计在内。 使用 preview.linked_or_processing 以计算链接记录,即使 include_linked=1. . . . . . . . . . . .

JSON · 妇女 HTTP 202 (韩语).
{
    "result": {
        "error": 0,
        "history": "sms-api",
        "action": "delete",
        "request_id": "6d54ac58-41f1-4fbc-9a39-6e6c86089451",
        "status": "processing",
        "completed": false,
        "count_delete": 100,
        "total_before": 250,
        "selected_at_start": 200,
        "protected_at_start": 50,
        "include_linked": 0,
        "continue_required": true,
        "message": "Repeat GET or POST with the same request_id and include_linked to continue. Status requests do not run deletion."
    }
}
  • 200 与 . completed=true: 完成( 完成) 。 仅200个预览或状态回复并不能证明完成 。
  • 400,000 个 INVALID_REQUEST_ID:检查格式。 404 (中文(简体) ). REQUEST_NOT_FOUND: 没有为此ID操作, API 键和历史。
  • 401: 证书无效或过期. 403: 不足 OAuth 范围或未经授权的账户。
  • 409 (中文(简体) ). HISTORY_BUSY: 正在运行另一个清理; 从原客户端继续. 409 (中文(简体) ). INCLUDE_LINKED_CONFLICT: 恢复原样 include_linked 值。
  • 409 (中文(简体) ). OAUTH_ACCOUNT_AMBIGUOUS: 提供 API 属于此账户的密钥。
  • 503或网络中断:一些批次可能已经完成. 检查配置, 然后用原版重试 request_id中,不自动创建替换操作。
后 获得

发送短消息

#
终 编https://api.smsmobileapi.com/sendsms/

查询连接电话中的信息 。 POST是当消息长或包含特殊字符时被推荐的.

什么时候用

用于交易信件,提醒,提醒以及应用程序生成的短消息.

参数

姓名类型所需经费描述
apikey 细绳 必需的 您的账户 API 密钥 。
recipients 电话 必需的 目的地编号,国际格式。
message 细绳 必需的 消息体相. 师曰. 使用GET时, URL 编码它 。
port 1 | 2 可选 兼容的Android设备上的SIM端口;留空供自动选择.
sIdentifiant 细绳 可选 特定连接的电话 SID; 将第一个可用的设备留为空 。
shorturl 0 | 1 可选 设定为 1 以缩短信件中找到的 URL 。
sendsms 0 | 1 可选 短消息频道旗. 省略时默认为 1 。
sendwa 0 | 1 可选 账户支持时, 也请求提供 WhatsApp 。
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."

示例回复

JSON
{
  "result": {
    "error": 0,
    "sent": "1",
    "id": "c319d3b35e8f8712cde20dae39ac3c19f86eda25",
    "note": "sent by mobile",
    "datetime": "2026-03-20T21:07:44Z",
    "port": null,
    "send_with_whatsapp": "0"
  }
}

想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。

连接密钥 QQ
很高兴知道
  • 一个成功的API响应意味着消息被平台接受;保留回回的ID以进行后期跟踪.
  • 载体的交付和移动处理可以在HTTP响应后发生.
后 获得

重新发送未发送的短信

#
终 编https://api.smsmobileapi.com/resend/

重试当前处于错误状态的信件 。

什么时候用

在检查发送的日志并确认一个失败的消息符合再次尝试的条件后使用此功能 。

参数

姓名类型所需经费描述
apikey 细绳 必需的 您的账户 API 密钥 。
guid 细绳 必需的 消息 GUID 由发送或日志端点返回 。

请求示例

库尔
curl "https://api.smsmobileapi.com/resend/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE"

示例回复

JSON
{
  "result": {
    "error": "0",
    "sms": "resent with successfully",
    "attempt": 1
  }
}

想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。

连接密钥 QQ
很高兴知道
  • 只有有错误状态的信件才能被怨恨.
得到

API 发送的列表短消息

#
终 编https://api.smsmobileapi.com/log/sent/sms/

返回通过短消息API提交的信息,并包含队列,移动和出错信息.

什么时候用

用于对交付情况进行监测,支持诊断和调节。

参数

姓名类型所需经费描述
apikey 细绳 必需的 您的账户 API 密钥 。
guid_message 细绳 可选 以它独特的 GUID 返回一个消息 。
before 时间戳或参考 可选 在提供的光标或时间戳前返回消息 。
error_api 0 | 1 可选 设定为 1 仅返回 API 处理错误 。
error_mobile 0 | 1 可选 设定为 1 只返回移动发送错误 。
keyword 细绳 可选 搜索收件人号码或信件文本 。

请求示例

库尔
curl "https://api.smsmobileapi.com/log/sent/sms/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"

示例回复

JSON
{
  "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": ""
    }]
  }
}

想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。

连接密钥 QQ
得到

列出手机同步的短消息

#
终 编https://api.smsmobileapi.com/log/sent/frommobile/

列出手机发送的短信,并与平台同步.

什么时候用

当消息可能发自电话和通过API时使用.

参数

姓名类型所需经费描述
apikey 细绳 必需的 您的账户 API 密钥 。
date 年-月-月-月 可选 过滤一个确切的日期。
date_from 年-月-月-月 可选 开始日期范围。
date_to 年-月-月-月 可选 约会范围结束 。
period 语句 可选 今天, 昨天, 24小时, 3天或7天。
number 电话 可选 由接收者过滤.
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"

示例回复

JSON
{
  "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"
    }]
  }
}

想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。

连接密钥 QQ
很高兴知道
  • 需要Androidapp 4.1.20或更新,必须在应用程序中启用.
  • 此端点返回同步历史最长为7天.
得到

收到名单短消息

#
终 编https://api.smsmobileapi.com/getsms/

从连接的电话返回进场的短消息同步。

什么时候用

使用它来构建收件箱,进行民意调查以获取回复,或在被网路中断后恢复消息.

参数

姓名类型所需经费描述
apikey 细绳 必需的 您的账户 API 密钥 。
sIdentifiantPhone 细绳 可选 由接收短信的电话过滤.
after_timestamp_unix 解开秒 可选 返回此时间戳后收到的信息 。
onlyunread 是的 可选 只返回未在 API 状态下标记的信件 。

请求示例

库尔
curl "https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY&onlyunread=yes"

示例回复

JSON
{
  "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
    }]
  }
}

想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。

连接密钥 QQ
后 获得

将收到的短信标为已读

#
终 编https://api.smsmobileapi.com/getsms/set-read/

标记一个收到消息, 以 SMSMobileAPI API 状态读取 。

什么时候用

处理信件后使用此选项 。

参数

姓名类型所需经费描述
apikey 细绳 必需的 您的账户 API 密钥 。
guid_message 细绳 必需的 接收到的短信的GUID.

请求示例

库尔
curl "https://api.smsmobileapi.com/getsms/set-read/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"

想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。

连接密钥 QQ
很高兴知道
  • 这不会改变电话消息应用程序内的读取状态.
后 获得

更新收到的短消息别名

#
终 编https://api.smsmobileapi.com/getsms/update/

添加,更改或清除与收到的短消息相关的别名.

什么时候用

使用别名在信件上附加联系人名称或应用程序标签.

参数

姓名类型所需经费描述
apikey 细绳 必需的 您的账户 API 密钥 。
guid 细绳 必需的 接收到的短信的GUID.
alias 细绳 必需的 新别名. 发送空值以清除它 。

请求示例

库尔
curl "https://api.smsmobileapi.com/getsms/update/?apikey=YOUR_API_KEY&guid=MESSAGE_GUID&alias=John%20Doe"

想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。

连接密钥 QQ
后 获得

删除短消息服务器日志

#
终 编https://api.smsmobileapi.com/deletesms/

从 SMSMobileAPI 服务器日志中删除短消息记录.

什么时候用

用于保留工作流程或删除已登录的特定信件。

参数

姓名类型所需经费描述
apikey 细绳 必需的 您的账户 API 密钥 。
guid_message 细绳 可选 由 GUID 删除一条消息 。
date_start 年-月-月-月 可选 删除该日期的记录。
date_end 年-月-月-月 可选 使用日期 启动,限制删除范围。

请求示例

库尔
curl "https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"

示例回复

JSON
{
  "result": {
    "error": null,
    "count_delete": 1
  }
}

想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。

连接密钥 QQ
很高兴知道
  • 仅删除服务器日志条目 。 它不删除存储在移动设备上的信件.
  • 将操作视为破坏性操作,并在调用前进行过滤.
得到

列出短信对话

#
终 编https://api.smsmobileapi.com/conversation/sms/list/

以电话号码将信件收发到对话中。

什么时候用

用于聊天视图、最近的对话部件和支持时间段 。

参数

姓名类型所需经费描述
apikey 细绳 必需的 您的账户 API 密钥 。
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"

示例回复

JSON
{
  "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"
    }]
  }]
}

想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。

连接密钥 QQ
得到

列出已连接的移动设备

#
终 编https://api.smsmobileapi.com/gateway/mobile/list/

列出连接到短信网关账户的电话.

什么时候用

使用它来选择发送器,显示设备状态或审计网关机队.

参数

姓名类型所需经费描述
apikey 细绳 必需的 您的账户 API 密钥 。
sid 细绳 可选 返回一个精确的移动SID。
search 细绳 可选 搜索SID,日期,电池,版本,标签和相关字段.

请求示例

库尔
curl "https://api.smsmobileapi.com/gateway/mobile/list/?apikey=YOUR_API_KEY"

想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。

连接密钥 QQ
后 获得

更新一个连接的移动

#
终 编https://api.smsmobileapi.com/gateway/mobile/update/

更新连接设备的可读标签或电话号码。

什么时候用

使用它来保持设备标签在多管设备中有意义的.

参数

姓名类型所需经费描述
apikey 细绳 必需的 您的账户 API 密钥 。
sid 细绳 必需的 设备SID.
label 细绳 必需的 新标签; 可能是有意的空的 。
phone_number 电话 可选 新的电话号码元数据。

请求示例

库尔
curl "https://api.smsmobileapi.com/gateway/mobile/update/?apikey=YOUR_API_KEY&sid=DEVICE_SID&label=OfficePhone"

想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。

连接密钥 QQ
后 获得

删除已连接的移动设备

#
终 编https://api.smsmobileapi.com/gateway/mobile/delete/

删除一个连接的移动及其网关历史行。

什么时候用

仅在电话必须永久从账户中取出时使用.

参数

姓名类型所需经费描述
apikey 细绳 必需的 您的账户 API 密钥 。
sid 细绳 必需的 要删除的设备的 SID 。

请求示例

库尔
curl "https://api.smsmobileapi.com/gateway/mobile/delete/?apikey=YOUR_API_KEY&sid=DEVICE_SID"

想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。

连接密钥 QQ
很高兴知道
  • 此操作会删除与 SID 相关的设备历史 。 呼叫前确认装置
原职

以网路标记接收短消息

#
继续Your HTTPS endpoint

SMSMobileAPI每当收到短消息时,都会向您配置的 URL 发送 JSON 请求 。

什么时候用

使用webhoks进行实时处理,而不是频繁投票.

接收者示例

前一頁 8
<?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';

示例回复

JSON
{
  "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"
}
入境终点

此端点接收您自己的 HTTPS URL 的事件 。 使用上面的接收器示例,然后发送到您连接的手机的短消息进行测试.

很高兴知道
  • 在 Dashboard 上配置公共 HTTPS URL 。
  • 快速返回 HTTP 200 并同步处理事件 。
  • 使用guid来重复复制.
后 获得

清空通过 API 发送的短信记录

#
终 编https://api.smsmobileapi.com/delete-history-sms-api/

清除服务器记录 : SMS 提交日期:2004年12月31日 API。它不记得电话已经收集的信息。

什么时候用

首先使用预览,检查计数,然后明确请求删除. 清除了全部选取的历史 API 键,没有日期、电话或信件过滤器。

参数

姓名类型所需经费描述
apikey 细绳 可选 需要时无需 OAuth2与 OAuth2,可选择选择 API 属于同一账户的密钥。
action 预览 QQ 删除 QQ 状态 可选 preview 只统计而不删除;delete 启动或继续删除;status 只查看进度。API 默认使用 delete,此测试工具默认使用 preview。
include_linked 0 | 1 可选 默认 0: 保留链接或处理记录. 设定1以包含,有破坏整合的风险. 继续删除时保持此值不变 。
request_id 细绳 可选 delete 和 status 必须提供,preview 可不提供。使用 16–128 个 ASCII 字母、数字、连字符 (-) 或下划线 (_)。每次新的删除操作生成一个唯一 ID,并在所有重试中保留同一个 ID。它不是消息 ID,也不是 API 密钥。

请求示例

库尔
curl -X POST "https://api.smsmobileapi.com/delete-history-sms-api/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=preview" -d "include_linked=0"
删除和查询状态的示例

替换样本 request_id 开始前,有你独特的价值。 以下删除请求更改真实账户历史; 它们不是预览 。

POST · 妇女 API 键
curl -X POST "https://api.smsmobileapi.com/delete-history-sms-api/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
POST · 妇女 OAuth2
curl -X POST "https://api.smsmobileapi.com/delete-history-sms-api/" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
GET 现状
curl -G "https://api.smsmobileapi.com/delete-history-sms-api/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=status" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

示例回复

JSON
{
    "result": {
        "error": 0,
        "history": "sms-api",
        "action": "preview",
        "total": 120,
        "simple": 100,
        "linked_or_processing": 20,
        "selected": 100,
        "include_linked": 0,
        "operation_in_progress": false,
        "active_include_linked": null
    }
}

想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。

连接密钥 QQ
很高兴知道
  • 以上示例为预览,而非删除. 计数是说明;删除开始时确定选择。
  • include_linked=1 可能破坏 GHL, , , , , , , , Zapier,自动化,不订阅链接或发送跟踪. 它从不绕过账户所有权或存储完整性检查.
后 获得

清空从手机发送的短信记录

#
终 编https://api.smsmobileapi.com/delete-history-sms-mobile/

清除同步记录 SMS 手机发送的不是手机上存储的信息

什么时候用

首先使用预览,检查计数,然后明确请求删除. 清除了全部选取的历史 API 键,没有日期、电话或信件过滤器。

参数

姓名类型所需经费描述
apikey 细绳 可选 需要时无需 OAuth2与 OAuth2,可选择选择 API 属于同一账户的密钥。
action 预览 QQ 删除 QQ 状态 可选 preview 只统计而不删除;delete 启动或继续删除;status 只查看进度。API 默认使用 delete,此测试工具默认使用 preview。
include_linked 0 | 1 可选 默认 0: 保留链接或处理记录. 设定1以包含,有破坏整合的风险. 继续删除时保持此值不变 。
request_id 细绳 可选 delete 和 status 必须提供,preview 可不提供。使用 16–128 个 ASCII 字母、数字、连字符 (-) 或下划线 (_)。每次新的删除操作生成一个唯一 ID,并在所有重试中保留同一个 ID。它不是消息 ID,也不是 API 密钥。

请求示例

库尔
curl -X POST "https://api.smsmobileapi.com/delete-history-sms-mobile/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=preview" -d "include_linked=0"
删除和查询状态的示例

替换样本 request_id 开始前,有你独特的价值。 以下删除请求更改真实账户历史; 它们不是预览 。

POST · 妇女 API 键
curl -X POST "https://api.smsmobileapi.com/delete-history-sms-mobile/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
POST · 妇女 OAuth2
curl -X POST "https://api.smsmobileapi.com/delete-history-sms-mobile/" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
GET 现状
curl -G "https://api.smsmobileapi.com/delete-history-sms-mobile/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=status" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

示例回复

JSON
{
    "result": {
        "error": 0,
        "history": "sms-mobile",
        "action": "preview",
        "total": 120,
        "simple": 100,
        "linked_or_processing": 20,
        "selected": 100,
        "include_linked": 0,
        "operation_in_progress": false,
        "active_include_linked": null
    }
}

想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。

连接密钥 QQ
很高兴知道
  • 以上示例为预览,而非删除. 计数是说明;删除开始时确定选择。
  • include_linked=1 可能破坏 GHL, , , , , , , , Zapier,自动化,不订阅链接或发送跟踪. 它从不绕过账户所有权或存储完整性检查.
后 获得

清空接收短信记录

#
终 编https://api.smsmobileapi.com/delete-history-sms-received/

清除服务器记录 SMS. 集成和自动化记录默认受到保护。

什么时候用

首先使用预览,检查计数,然后明确请求删除. 清除了全部选取的历史 API 键,没有日期、电话或信件过滤器。

参数

姓名类型所需经费描述
apikey 细绳 可选 需要时无需 OAuth2与 OAuth2,可选择选择 API 属于同一账户的密钥。
action 预览 QQ 删除 QQ 状态 可选 preview 只统计而不删除;delete 启动或继续删除;status 只查看进度。API 默认使用 delete,此测试工具默认使用 preview。
include_linked 0 | 1 可选 默认 0: 保留链接或处理记录. 设定1以包含,有破坏整合的风险. 继续删除时保持此值不变 。
request_id 细绳 可选 delete 和 status 必须提供,preview 可不提供。使用 16–128 个 ASCII 字母、数字、连字符 (-) 或下划线 (_)。每次新的删除操作生成一个唯一 ID,并在所有重试中保留同一个 ID。它不是消息 ID,也不是 API 密钥。

请求示例

库尔
curl -X POST "https://api.smsmobileapi.com/delete-history-sms-received/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=preview" -d "include_linked=0"
删除和查询状态的示例

替换样本 request_id 开始前,有你独特的价值。 以下删除请求更改真实账户历史; 它们不是预览 。

POST · 妇女 API 键
curl -X POST "https://api.smsmobileapi.com/delete-history-sms-received/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
POST · 妇女 OAuth2
curl -X POST "https://api.smsmobileapi.com/delete-history-sms-received/" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"
GET 现状
curl -G "https://api.smsmobileapi.com/delete-history-sms-received/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=status" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

示例回复

JSON
{
    "result": {
        "error": 0,
        "history": "sms-received",
        "action": "preview",
        "total": 120,
        "simple": 100,
        "linked_or_processing": 20,
        "selected": 100,
        "include_linked": 0,
        "operation_in_progress": false,
        "active_include_linked": null
    }
}

想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。

连接密钥 QQ
很高兴知道
  • 以上示例为预览,而非删除. 计数是说明;删除开始时确定选择。
  • include_linked=1 可能破坏 GHL, , , , , , , , Zapier,自动化,不订阅链接或发送跟踪. 它从不绕过账户所有权或存储完整性检查.

故障排除

错误和安全的重试

在重试前读取 HTTP 状态和 JSON 错误字段 。 不先更正请求, 不重试验证或认证失败 。

HTTP代码怎么办
400missing_parameter需要的参数为空或缺失 。 请检查endpoint的参数表.
403invalid_apikeyAPI 密钥未知, 过期或未授权用于请求的特性 。
429too_many_requests请求来得太快了 等等,然后用指数回放来重试.
500server_error服务无法完成请求 。 如果持续,则保持响应和联系支持。
重试规则重试仅进行瞬态429和5xx响应. 1秒后开始,然后回到2,4和8秒.

需要帮助吗?

带上请求的背景 而不是你的秘密

共享端点,时间戳,HTTP状态和消毒响应. 永远不要包括API密钥,指使或私人消息内容.

联系API支持