短信接口对接添加模板详情

乐讯通云通信

于 2024-02-21 17:45:01 发布

阅读量683

点赞数 10

文章标签：前端 javascript 开发语言网络 java c# python

本文链接：https://blog.csdn.net/kuaixunhuaruan/article/details/136217323

版权

本文详细介绍了如何通过POST方式在HTTP请求中使用参数，包括MD5加密、时间戳、签名生成，以及成功和失败响应的JSON和XML格式示例。重点讲解了sign参数的计算方法和data参数的结构。

摘要由CSDN通过智能技术生成

请求协议：http

请求方式：采用post方式提交请求

请求报文

username=zhangsan&password=E10ADC3949BA59ABBE56E057F20F883E&timestamp=636949832321055780&sign=96E79218965EB72C92A54&rece=json&templateid=A7C5779F

参数说明

参数名称	是否必须	描述	示例
username	是	账户名	username=zhangsan
password	是	账户密码，密码必须MD5加密并且取32位大写	password=E10ADC3949BA59ABBE56E057F20F883E
timestamp	是	时间戳，13位时间戳，单位（毫秒）	timestamp=636949832321055780
sign	是	签名校验	sign=96E79218965EB72C92A54
rece	否	返回类型json、xml，默认(json)	rece=json
templateid	是	模板ID	templateid=A7C5779F

sign参数详细说明

签名由参数username,password,timestamp进行MD5加密组成

比如这些值拼接后为username=zhangsan&password=E10ADC3949BA59ABBE56E057F20F883E&timestamp=636949832321055780，那么就MD5加密这个参数字符串得到结果后作为sign的值sign=96E79218965EB72C92A54

响应报文

参数名称	描述	示例
returnstatus	返回状态	"returnstatus":"success"
code	返回编码，0为正常	"code":"0"
remark	备注	"remark":"获取成功"
data	返回数据	"data":{...}

data参数说明

参数名称	描述	示例
templateid	模板ID	"templateid":"0AA20BD7"
type	模板类型	"type":"会员通知"
sign	模板签名	"sign":"乐讯通"
message	模板内容	"message":"您的验证码是{s6}"
free	是否免审，0-否，1-是	"free":0
state	审核状态	"state":"审核通过"
createDate	创建时间	"createDate":"2020-06-05 18:02:28"
auditDate	审核时间	"auditDate":"2020-06-05 18:17:59"

JSON成功返回示例

{
    "returnstatus":"success",
    "code":"0",
    "remark":"获取成功",
    "data":{
        "templateid":"0AA20BD7",
        "type":"会员通知",
        "sign":"乐讯通",
        "message":"您的验证码是{s6}",
        "free":0,
        "state":"审核通过",
        "createDate":"2020-06-01 18:02:28",
        "auditDate":"2020-06-01 18:17:59"
    }
}

JSON失败返回示例

{
    "returnstatus":"error",
    "code":"-4",
    "remark":"账户密码错误！"
}

XML成功返回示例

<?xml version="1.0" encoding="utf-8"?><returnsms>
  <returnstatus>success</returnstatus>
  <code>0</code>
  <remark>获取成功</remark>
  <data>
    <templateid>0AA20BD7</templateid>
    <type>会员通知</type>
    <sign>乐讯通</sign>
    <message>您的验证码是{s6}</message>
    <free>0</free>
    <state>审核通过</state>
    <createDate>2020-06-05 18:02:28</createDate>
    <auditDate>2020-06-05 18:17:59</auditDate>
  </data>
</returnsms>

XML失败返回示例

<?xml version="1.0" encoding="gb2312"?><returnsms>
  <returnstatus>error</returnstatus>
  <code>-4</code>
  <remark>账户密码错误！</remark>
</returnsms>