发自定义短信HTTP接口


接口概述

所谓自定义接口,是指发送的内容、签名都可以有客户自定义完成,通过接口传递到秒信云平台。

提交自定义短信发送

  • 提交地址::http(s)://www.51miaoxin.com/sms/send
  • 提交方法:POST
  • 提交格式:application/x-www-form-urlencoded
字段 必填 类型 描述
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参数最终会被短信状态回调的时候同步给客户。
接口应答JSON格式如下
{
      "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":"运营商返回异常"
            }
       ]
  }
接口应答JSON数据含义
变量名 必返 类型 含义
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 秒信系统平台接收此下发需求的时间

results matching ""

    No results matching ""