接口对接发送通知短信添加模版JSON成功失败案例

原创已于 2025-06-16 17:45:19 修改 · 642 阅读

5 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#json #xml #前端

于 2025-06-16 17:42:57 首次发布

请求协议：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（会员通知）

响应报文

参数名称	描述	示例
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":"账户密码错误！"
}