所谓自定义接口,是指发送的内容、签名都可以有客户自定义完成,通过接口传递到秒信云平台。
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| account | √ | string | 参考:短信HTTP 接口对接总览 |
| token | √ | string | 参考:短信HTTP 接口对接总览 |
| ts | √ | string | 参考:短信HTTP 接口对接总览 |
| mobiles | √ | string | 接受短信用户的手机号码,多个手机用半角字符“,”分开。 如:“18600001111,18600002222”,每个手机号11位数字。 账号开启加密后手机号则为加密后的密文。 |
| content | √ | string | 具体短信内容,以UTF-8方式传递。 如果要对mobiles 多个目标用户下发不同的内容,这里请注意保持数量跟mobiles 分割后的数量保持一致。 content 参数生成方法如下,考虑到内容会包含中文,这个字段用URLEncode方法进行字符转码: content = URLEncode( URLEncode(content1) + “|||” + URLEncode(content2) ) 对所有要拼接的内容做一下URLEncode,然后用三个连接符“|||”拼接,最后再做一下URLEncode。 如果mobiles 参数出现多个目标号码,但是content只有一个内容,那么所有目标号码将会发送同一样的内容。 部分语言/框架不支持自动URLEncode的,可能需要两次编码,可以用 + & &等内容测试检验。 账户开启短信内容加密后短信内容则为加密后在进行URL转码; 可参考 手机号+内容加密 |
| ext | x | string | 客户的自定义扩展号码,将会出现在发送号码的尾部,具体可以扩展的位数请提前商定,超出12位会返回错误。可以不填,填写就只能填数字。 |
| ref | x | string | 客户可以对提交的短信加入reference参数以便后续进行跟踪,设置的ref参数最终会被短信状态回调的时候同步给客户。 |
{
"code":0,
"msg":"发送成功",
"total":2,
"result":[
{
"mobile":"18600000001",
"order_id":"1839347820929302091",
"code":0,
"receive_time":"2016-12-22 23:11:40",
"msg":"处理中"
},
{
"order_id":"1839347820929302093",
"mobile":"18600000000",
"code":-11,
"receive_time":"2016-02-22 23:11:40",
"msg":"运营商返回异常"
}
]
}
| 变量名 | 必返 | 类型 | 含义 |
|---|---|---|---|
| code | √ | int | 0代表成功,负数代表失败 |
| msg | √ | string | code状态对应的中文解释 |
| total | √ | int | 代表本次收到多少个短信发送请求,数量会和mobiles的手机号数量一致 |
| result | √ | array | 状态的汇报信息是一个数组,会对每一个手机号码的下发请求做单独的汇报 |
| result.order_id | √ | string | 代表秒信系统平台的订单id,可以用此id做订单状态的查询,此id为纯数字,订单id的前六位同时代表年月日 |
| result.code | √ | int | 0代表成功 负数代表失败 详见:错误代码对应表 此code仅代表单条号码发送状态的标记 |
| result.msg | √ | string | reports.code状态对应的中文解释 |
| result.mobile | √ | string | 发送的目标客户手机号码 账号开启加密后手机号则为加密后的密文。 |
| result.receive_time | √ | string | 秒信系统平台接收此下发需求的时间 |