短信发送

批量发送短信

批量发送短信接口，支持向多个手机号发送不同签名、同一个模板（可以是不同模板变量）的短信。

请求说明

请求地址：https://smssh.253.com/sms/v2/batch-send

请求方式、Content-Type、编码格式及公共请求头参数，请参见 API调用说明

请求体参数

名称	类型	必填	描述	示例值
productType	String	是	产品类型：`notify`-通知短信；`market`-营销短信；`verify`-验证码短信；`2ec`-CS短信（二类电商）；`finance`-DK短信（金融）；`game`-BK短信（游戏）；`acquisition`-HK短信（拉新）	`market`
phoneNumbers	String	是	接收短信的手机号 - 号码格式无需添加区号或者+号，只填写11位手机号。 - 多个手机号使用英文逗号间隔，一次不要超过 1000 个。	1580000**,1530000**
templateCode	String	是	模板ID - 您可以在短信服务控制台的模板管理页面查看模板ID，必须使用已审核通过的模板。	1111111
templateParam	String	条件必填	变量参数值，JSON数组字符串格式。 - 模板有变量时必传，无变量时可不传。 - 数组元素个数必须与 `phoneNumbers` 的手机号个数一致。 - 键名使用 param1、param2、param3...依次对应模板中的变量。 - 由于该字段值为字符串，内部的引号需使用 `\"` 转义，详见请求示例。	`"[{\"param1\":\"张三\"}]"`
signName	String	条件必填	短信签名 - 如果之前报备的模板没有选择关联签名，则为必传，需要通过此参数带上签名。 - 自25年7月起最新的模板报备中会选择关联签名，则可以不用传递此参数。	【创蓝云智】
report	String	否	状态回执开关 - 需要获取状态回执传"true"，不传默认为"false"，无法获取状态回执。	true
callbackUrl	String	否	状态回执的回调地址 - 请传入完整带http协议头开头的地址，不传默认为空，请勿传入空格，否则会造成地址推送错误。	https://example.com/callback
smsUpExtendCode	String	否	下发短信号码扩展码 - 用于匹配上行回复，上行报告会回传。一般5位以内(只支持传数字)，不传默认为空。	555
outId	String	否	自定义参数 - 如订单号或短信发送记录流水号，状态回执会回传，最大支持256位。	321abc

请求示例

{
  "productType": "market",
  "phoneNumbers": "15800000000,15300000000",
  "templateCode": "1111111",
  "templateParam": "[{\"param1\":\"张三\",\"param2\":\"13\"},{\"param1\":\"李四\",\"param2\":\"88\"}]",
  "signName": "【创蓝云智】",
  "report": "true",
  "callbackUrl": "https://example.com/callback",
  "smsUpExtendCode": "555",
  "outId": "321abc"
}

响应体参数

名称	类型	说明	示例值
code	String	请求状态码：`000000`代表成功；其他错误码请参见接口响应状态码说明。	`000000`
msg	String	提示信息，成功时返回 success。	`success`
requestId	String	请求ID，随机生成的 UUID。	`2CBBEDF76FB64E3EB924DA3958B7D6BB`
data	Object	返回的数据结构，JSON格式。请求失败时不返回。	-
-successNum	String	提交成功条数。	-
-failNum	String	提交失败条数。	-
-msgId	String	消息 id（32 位纯数字）。	-

响应示例

{
  "code": "000000",
  "msg": "success",
  "requestId": "2CBBEDF76FB64E3EB924DA3958B7D6BB",
  "data": {
    "failNum": "0",
    "successNum": "2",
    "msgId": "26073016585700902202000045962837"
  }
}

产品中心

热门搜索

中国站

国际站

批量发送短信

请求说明

请求体参数

请求示例

响应体参数

响应示例