模板上传

访问地址:https://www.dh3t.com/json/sms/v2/upload/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 

{
    "sign": "【大汉三通】",
    "content": "尊敬的用户您好!为提升服务体验,现需您完成 [业务办理/信息核对/活动参与]。如有疑问,可联系:客服热线:${0,12} 专属顾问:${0,11} 请点击链接完成操作:${0,20} 感谢您的配合!",
    "remark": "",
    "paramType": [
        "6",
        "6",
        "5"
    ],
    "combinePhones": [
        {
            "phone1": "4008208121""phone2": "18696767245"
        }
    ],
    "reportUrls": [
        {
            "url": "https://www.dh3t.com",
            "icpRecordNumber": "沪ICP备13045861号",
            "icpCompanyName": "上海大汉三通数据通信有限公司",
            "enterpriseCode": "9131011576398057XR"
        }
    ],
    "phoneReportInfo": {
        "4008208121": {
            "belongName": "张三",
            "certificateNumber": "321612199311112222",
            "certificateType": "A",
            "type": 3,
            "unitName": "单位1"
        },
        "18696767245": {
            "belongName": "李四",
            "certificateNumber": "321612199311112223",
            "certificateType": "A",
            "type": 1,
            "unitName": "单位2"
        }
    }
}

请求参数:

参数名数据类型必要性说明
signString必填签名
contentString必填模板内容,长度不能超过2000个字符,变量采用:${n,m}的格式,匹配n到m个文字,n小于等于m,n大于等于0,m小于等于30
remarkString选填短信模板备注,长度不能超过1000个字符
paramTypeList[String]必填模板变量类型
reportUrlsList[Object]条件填写报备的链接集合;备注:如果内容中存在链接变量,则需要填写该信息
urlString条件填写短链接,长度不能超过100个字符
icpRecordNumberString条件填写Icp备案编号,长度不能超过255个字符
icpCompanyNameString条件填写Icp备案企业名称,长度不能超过255个字符
longUrlString选填短链接对应的落地页长链接,长度不能超过255个字符
domainString选填短链对应的一级域名,长度不能超过255个字符
enterpriseCodeString条件填写企业社会信用统一代码,长度不能超过255个字符
reportPhonesList[String]条件填写报备的单号码集合,需要在短信内容中发送的单号码;
备注:如果内容中存在单个号码变量,则需要填写该信息
combinePhonesList[Object]条件填写报备的组合号码集合 需要在短信内容中组合发送的两个号码;
备注:如果内容中存在多个号码变量,则需要填写该信息,号码1号码2可以相同
phone1String条件填写电话号码1,长度不能超过20个字符
phone2String条件填写电话号码2,长度不能超过20个字符
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"
}

返回参数说明:

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