短信接口对接怎么添加模板

乐讯通云通信

于 2024-01-31 10:57:50 发布

阅读量438

点赞数 12

文章标签：网络 java c# python php

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

版权

模板接口适用于文字短信

请求协议：http

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

请求报文

username=zhangsan&password=E10ADC3949BA59ABBE56E057F20F883E&timestamp=636949832321055780&sign=96E79218965EB72C92A54&rece=json&message=【乐讯通】您的验证码是{s6}&type=sms&free=0

参数说明

参数名称	是否必须	描述	示例
username	是	账户名	username=zhangsan
password	是	账户密码，密码必须MD5加密并且取32位大写	password=E10ADC3949BA59ABBE56E057F20F883E
timestamp	是	时间戳，13位时间戳，单位（毫秒）	timestamp=636949832321055780
sign	是	签名校验	sign=96E79218965EB72C92A54
rece	否	返回类型json、xml，默认(json)	rece=json
message	是	短信模板，短信签名必带	message=【乐讯通】您的验证码是{s6}
type	是	模板类型	type=sms
free	否	是否需要免审，默认0，可选值1，0	free=0

sign参数详细说明

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

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

type参数详细说明

模板类型可选值有sms（会员通知），marketing（会员营销），yzm（验证码），notice（变量通知），shanxin（弹屏闪信），voice（语音短信），internation（国际短信）

响应报文

参数名称	描述	示例
returnstatus	返回状态	"returnstatus":"success"
code	返回编码，0为正常	"code":"0"
remark	备注	"remark":"模板保存成功"
templateid	模板ID	"templateid":"0AA20BD7"

JSON成功返回示例

{
    "returnstatus":"success",
    "code":"0",
    "remark":"模板保存成功"
    "templateid":"0AA20BD7"
}

JSON失败返回示例

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

XML成功返回示例

<?xml version="1.0" encoding="utf-8"?><returnsms>
  <returnstatus>success</returnstatus>
  <code>0</code>
  <remark>模板保存成功</remark>
  <templateid>0AA20BD7</templateid>
</returnsms>

XML失败返回示例

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