帮助中心

1030-请求短信发送

2021-09-13

接口编号 1030

接口说明

1.向用户发送短信消息

2.支持批量发送,最大数据行数限制100

3.0=验证码通道, 1=营销通道

4.消息内容不能为空

请求说明

  • HTTP请求方式:POST

  • 返回数据格式:JSON

  • 请求路径:api/message/smsSend

请求参数

字段类型为空长度描述
Channelint
通道:0=验证码通道, 1=营销通道
Typestring
1-12消息类型,可以为发送消息定义不同的类型,方便后期归类
Contentstring1-256消息内容,不需要带签名,说明:关于短信计算条数的字符个数规则,详细咨询EZR
TargetsJson数组
发送对象列表,批量时,发送目标不可超过100

Targets数据结构

字段类型为空长度描述
Clientstring
发送对象终端。指手机号码
Argsstring
可以定制消息的内容,按模板格式发送,见例:若对每个发送终端的发送内容一致, 该值设置为空

请求参数示例代码(json对象)

{
   "Channel": 1,
   "Type": "CX",
   "Content": "尊敬的{姓名}你好,10-1将至,送你一张券{券号},快到店里来看看吧",
   "Targets": [{
       "Client": "189********",
       "Args": "姓名:小明,券号:232390123"
   }, {
       "Client": "181********",
       "Args": "姓名:小华,券号:232390122"
   }, {
       ...
   }]
}


系统级返回结果示例(json)

{
   "Status": true,
   "StatusCode": 200,
   "Msg": "成功或失败的手机号,逗号分隔",
   "Timestamp": "20150622093101",
   "Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",
   "Result": 见业务返回结果示例,
}

业务返回结果示例(json对象):

内容1,代表成功发送消息行数


3642