批量发送短信

接口说明

批量发送短信，支持一次向多个手机号发送。

请求信息

• 获取公私钥：ACCESSKEY_ID:ACCESSKEY_SECRET
• 请求方法：POST
• 请求路径：/api/v1/usms/SendBatchUSMSMessage
• Content-Type：application/json

TaskContentarray必填

通过表单列表逐条添加发送任务，组件会自动拼装为 TaskContent JSON 结构。

TaskContent 预览

以下内容会被自动拼装到请求体中。

[
  {
    "TemplateId": "template_id_1",
    "SenderId": "uSpeedo",
    "Target": [
      {
        "Phone": "13800138000",
        "TemplateParams": [
          "123456"
        ]
      }
    ]
  }
]

任务 1

模板 ID发送方 ID手机号模板变量

Body 参数

参数名	类型	必填	说明	示例值
TaskContent	array	是	发送任务列表	见下方结构说明

TaskContent 数组元素说明

每个元素包含以下字段：

参数名	类型	必填	说明	示例值
TemplateId	string	是	模板 ID	"template_id_1"
SenderId	string	是	发送方标识（发送方名称）	"uSpeedo"
Target	array	是	目标手机号列表	见下方说明

Target 数组元素说明

每个元素包含以下字段：

参数名	类型	必填	说明	示例值
Phone	string	是	手机号	"13800138000"
TemplateParams	array	否	模板参数（按模板变量顺序填写）	["123456"]

响应格式

成功响应

{
  "RetCode": 0,
  "Message": "success",
  "SessionNo": ["session_no_1", "session_no_2"],
  "FailedTargetPhones": []
}

响应字段说明

字段名	类型	说明
RetCode	int	返回码，0 表示成功
Message	string	返回消息
SessionNo	array	会话号列表，用于查询发送状态
FailedTargetPhones	array	发送失败的手机号列表，元素含 Phone、TemplateParams、FailureReason

错误响应

{
  "RetCode": 215392,
  "Message": "Invalid parameter [TemplateId]"
}

常见错误码

错误码	说明
0	成功
215392	参数错误
215397	缺少必填参数
215400	服务器错误

语言

凭证

👁️

🔒

🔑登录获取 ACCESSKEY_ID 和 ACCESSKEY_SECRET

请求地址

POST

CURL 请求▼

curl -X POST "https://api.uspeedo.com/api/v1/usms/SendBatchUSMSMessage" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Basic $(echo -n 'ACCESSKEY_ID:ACCESSKEY_SECRET' | base64)" \
  -d '{
  "TaskContent": [
    {
      "TemplateId": "template_id_1",
      "SenderId": "uSpeedo",
      "Target": [
        {
          "Phone": "13800138000",
          "TemplateParams": [
            "123456"
          ]
        }
      ]
    }
  ]
}'

响应

示例成功响应错误响应（无效 TemplateId）

点击“发起请求”后，可在此查看响应结果。