接口对接发送文字短信JSON成功失败案例

最新推荐文章于 2026-06-24 14:31:09 发布

原创最新推荐文章于 2026-06-24 14:31:09 发布 · 1.6k 阅读

30 ·

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

GEO检测

标签

#json

请求协议：http

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

请求报文

action=sendtemplate&username=zhangsan&password=E10ADC3949BA59ABBE56E057F20F883E&token=894gbhy&templateid=638fgths&param=手机号1|参数1|参数2@手机号2|参数1|参数2&rece=json&timestamp=636949832321055780&sign=96E79218965EB72C92A54

如果模板内容存在参数则每个手机号返回一个taskID，反之返回一个taskID

参数说明

参数名称	是否必须	描述	示例
action	是	操作类型	(固定值)action=sendtemplate
username	是	账户名	username=zhangsan
password	是	账户密码，密码必须MD5加密并且取32位大写	password=E10ADC3949BA59ABBE56E057F20F883E
token	是	产品总览页面对应产品的Token	token=894gbhy
templateid	是	模板管理报备的模板ID	templateid=638fgths
param	是	发送参数，可发送一个或多个手机号，建议单次提交最多5000个号码	17712345678\|张三\|2541@13825254141\|李四\|2536
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

param参数详细说明

发送一个手机号模板为【手机号1|参数1|参数2】

发送多个手机号模板为【手机号1|参数1|参数2@手机号2|参数3|参数4@......】

第一列必须为手机号，参数1，参数2对应短信模板里的参数顺序，英文竖线隔开，比如短信模板为【签名】您好，{s6},您的验证码是：{s6},参数1就对应您好后边的{s6},参数2对应验证码是后边的{s6}, 多个手机号以@隔开

若模板内没有参数则只输入手机号即可

sign参数详细说明

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

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

响应报文

参数名称	描述	示例
returnstatus	响应状态	"returnstatus":"success"
code	响应返回码	"code":"0"
taskID	任务ID，带参数任务每个手机号生成一个任务ID，不带参数任务只返回一个任务ID	{"tel_17733865073":"15913494519502337"}
remark	响应错误返回说明	"remark":"访问超时！"

JSON成功返回示例

模板带参数返回
{
    "returnstatus":"success",
    "code":"0",
    "taskID":[
        {
            "tel_17712345678":"15913494519502337"
        }
    ]
}
模板不带参数返回
{
    "returnstatus":"success",
    "code":"0",
    "taskID":"15913523557540ece"
}

JSON失败返回示例

{
    "returnstatus":"error",
    "code":"-51",
    "remark":"访问超时！"
}