帮助中心
进入EZR

1030-请求短信发送

2021-09-13

接口编号 1030

接口说明

1.向用户发送短信消息

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

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

4.消息内容不能为空

请求说明

  • HTTP请求方式：POST

  • 返回数据格式：JSON

  • 请求路径：api/message/smsSend

请求参数

字段类型为空长度描述
Channelint否
通道：0=验证码通道， 1=营销通道
Typestring是
1-12消息类型，可以为发送消息定义不同的类型，方便后期归类
Contentstring否1-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，代表成功发送消息行数


3417