模板修改

访问地址:https://www.dh3t.com/json/sms/v2/update/template

提交方式:

该接口数据输入输出均采用json格式封装的字符串,编码(对整个请求的字符串编码)统一为UTF-8,采用post方式提交请求。

请求头参数:

全局参数

请求参数示例:

参数值说明:以下json内容为提交请求数据格式

POST https://www.dh3t.com/json/sms/v2/upload/template
Authorization:
ZGgxODUyODpkOGVmZThkNDIwMDA0OWEzNTVkZDlkMDg3YzRjYzExYw==
Date: 2025-07-15 09:55:01
User-Agent: Apifox/1.0.0 (https://www.apifox.cn)
Content-Type: application/json
Accept: */*
Host:     127.0.0.1:8002
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Body 类型 : application/json 


{
    "templateId": "2c90828a9840915901984fea42030a1c",
    "sign": "【测试签名】",
    "content": "这是一条测试短信${1,10}内容,变量为${1,10}",
    "remark": "测试备注",
    "paramType": ["5","6"],
    "urls": [
        url:"13800001111",
        "icpRecordNumber":"",
        "icpCompanyName":"",
        "longUrl":"",
        "domain":"",
        "enterpriseCode":""
            ],
    "phones": ["13800001111"],
    "phoneReportInfo": {
        "13800001111": {
            "belongName": "张三",
            "certificateNumber": "321612199311112222",
            "certificateType": "A",
            "type": 1,
            "unitName": "单位1",
            "evidence":"证明材料文件的base64字符串"
        }
    }
}

请求参数:

参数名数据类型必要性说明
templateIdString必填模板id
signString必填签名
contentString必填模板内容,长度不能超过2000个字符
remarkString选填短信模板备注,,长度不能超过1000个字符
paramTypeList[String]条件填写模板变量类型
urlsList[Object]条件填写需要修改的链接报备信息集合
urlString条件填写短链接,长度不能超过100个字符
icpRecordNumberString条件填写Icp备案编号,长度不能超过255个字符
icpCompanyNameString条件填写Icp备案企业名称,长度不能超过255个字符
longUrlString选填短链接对应的落地页长链接,长度不能超过255个字符
domainString选填短链对应的一级域名,长度不能超过255个字符
enterpriseCodeString条件填写企业社会信用统一代码,长度不能超过255个字符
phonesList[String]条件填写需要修改的电话号码报备信息集合
phoneReportInfoMap[String,Object]条件填写key为电话号码,value是电话的具体信息;

备注:如果内容中存在号码变量,则需要填写该号码信息
结构示例:
“phoneReportInfo”: {
“13322222222”:{
“type”: “1”,
“belongName”: “张三”,
“certificateType”: “A”,
“certificateNumber”: “XX”,
“unitName”: “公司1”,
“evidence”: “Y2uY2U=”
}
}

${key}String条件填写phoneReportInfo中的key的电话号码
${value}Object选填phoneReportInfo中的value的电话号码具体信息
typeInteger条件填写号码类型
belongNameString选填所属人姓名,长度不能超过255个字符
certificateTypeString选填证件类型 填写了证件类型,证件号码也需要填写
certificateNumberString选填证件号码,长度不能超过32个字符
unitNameString选填单位名称,长度不能超过255个字符
evidenceString选填证明材料文件的base64字符串

返回参数示例:

{
    "result":"0",
    "desc":"提交成功",
    "templateId":"2c9282395f2400ee015f24105ee20000",
    "invalidData":{"invalidReportUrls":["url":"","desc":"","combinePhone":"","desc":"","invalidCombinePhones",[""]}
}

响应参数:

参数名数据类型必要性说明
resultString必填响应状态码
descString必填响应描述
teamplateIdString必填 模板id
invalidDataObject选填无效的数据
invalidReportUrlsList[Object]选填无效的链接列表
urlString选填链接
descString选填无效原因
invalidPhonesList[Object]选填无效的手机号列表
phoneString选填无效的手机号
descString选填无效原因
invalidCombinePhonesList[Object]选填无效的组合号码
combinePhoneObject选填无效的手机号
descString选填无效原因
文档更新时间: 2025-11-07 14:03   作者:王超