视频短信可用于信息发布,企业宣传等场景,内容更丰富,展现更直观。
请求协议:http
请求方式:采用post方式提交请求
请求报文
action=sendvideo&username=zhangsan&password=E10ADC3949BA59ABBE56E057F20F883Etoken=894gbhy&mobile=手机号1,手机号2,手机号3&templateid=d6c1b927&rece=json×tamp=636949832321055780&sign=96E79218965EB72C92A54
参数说明
参数名称 | 是否必须 | 描述 | 示例 |
---|---|---|---|
action | 是 | 操作类型 | (固定值)action=sendvideo |
username | 是 | 账户名 | username=zhangsan |
password | 是 | 账户密码,密码必须MD5加密并且取32位大写 | password=E10ADC3949BA59ABBE56E057F20F883E |
token | 是 | 产品总览页面对应产品的Token | token=894gbhy |
mobile | 是 | 发送的手机号 | mobile=手机号1,手机号2,手机号3 |
templateid | 是 | 模板ID | templateid=d6c1b927 |
dstime | 否 | 设置要发送短信的时间,精确到秒(yyyy-MM-dd HH:mm:ss) | 2017-01-05 16:23:23 |
rece | 否 | 返回类型json、xml,默认(json) | rece=json |
timestamp | 是 | 时间戳,13位时间戳,单位(毫秒) | timestamp=636949832321055780 |
sign | 是 | 签名校验 | sign=96E79218965EB72C92A54 |
sign参数详细说明
签名由参数action,username,password,token,timestamp进行MD5加密组成
比如这些值拼接后为action=sendvideo&username=zhangsan&password=E10ADC3949BA59ABBE56E057F20F883E&token=894gbhy×tamp=636949832321055780,那么就MD5加密这个参数字符串得到结果后作为sign的值sign=96E79218965EB72C92A54
响应报文
参数名称 | 描述 | 示例 |
---|---|---|
returnstatus | 响应状态 | "returnstatus":"success" |
code | 响应返回码 | "code":"0" |
taskID | 任务ID | "taskID":"15914102484990599" |
remark | 响应错误返回说明 | "remark":"访问超时!" |
JSON成功返回示例
{
"returnstatus":"success",
"code":"0",
"taskID":"15914102484990599"
}
JSON失败返回示例
{
"returnstatus":"error",
"code":"-4",
"remark":"账户密码错误!"
}
XML成功返回示例
<?xml version="1.0" encoding="utf-8"?><returnsms>
<returnstatus>success</returnstatus>
<code>0</code>
<taskID>15914102421552674</taskID>
</returnsms>
XML失败返回示例
<?xml version="1.0" encoding="gb2312"?><returnsms>
<returnstatus>error</returnstatus>
<code>-4</code>
<remark>账户密码错误!</remark>
</returnsms>