模板修改
提交方式:
该接口数据输入输出均采用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字符串"
}
}
}请求参数:
| 参数名 | 数据类型 | 必要性 | 说明 | ||
|---|---|---|---|---|---|
| templateId | String | 必填 | 模板id | ||
| sign | String | 必填 | 签名 | ||
| content | String | 必填 | 模板内容,长度不能超过2000个字符 | ||
| remark | String | 选填 | 短信模板备注,,长度不能超过1000个字符 | ||
| paramType | List[String] | 条件填写 | 模板变量类型 | ||
| urls | List[Object] | 条件填写 | 需要修改的链接报备信息集合 | ||
| url | String | 条件填写 | 短链接,长度不能超过100个字符 | ||
| icpRecordNumber | String | 条件填写 | Icp备案编号,长度不能超过255个字符 | ||
| icpCompanyName | String | 条件填写 | Icp备案企业名称,长度不能超过255个字符 | ||
| longUrl | String | 选填 | 短链接对应的落地页长链接,长度不能超过255个字符 | ||
| domain | String | 选填 | 短链对应的一级域名,长度不能超过255个字符 | ||
| enterpriseCode | String | 条件填写 | 企业社会信用统一代码,长度不能超过255个字符 | ||
| phones | List[String] | 条件填写 | 需要修改的电话号码报备信息集合 | ||
| phoneReportInfo | Map[String,Object] | 条件填写 | key为电话号码,value是电话的具体信息;
备注:如果内容中存在号码变量,则需要填写该号码信息 |
||
| ${key} | String | 条件填写 | phoneReportInfo中的key的电话号码 | ||
| ${value} | Object | 选填 | phoneReportInfo中的value的电话号码具体信息 | ||
| type | Integer | 条件填写 | 号码类型 | ||
| belongName | String | 选填 | 所属人姓名,长度不能超过255个字符 | ||
| certificateType | String | 选填 | 证件类型 填写了证件类型,证件号码也需要填写 | ||
| certificateNumber | String | 选填 | 证件号码,长度不能超过32个字符 | ||
| unitName | String | 选填 | 单位名称,长度不能超过255个字符 | ||
| evidence | String | 选填 | 证明材料文件的base64字符串 | ||
返回参数示例:
{
"result":"0",
"desc":"提交成功",
"templateId":"2c9282395f2400ee015f24105ee20000",
"invalidData":{"invalidReportUrls":["url":"","desc":"","combinePhone":"","desc":"","invalidCombinePhones",[""]}
}
响应参数:
| 参数名 | 数据类型 | 必要性 | 说明 | ||
|---|---|---|---|---|---|
| result | String | 必填 | 响应状态码 | ||
| desc | String | 必填 | 响应描述 | ||
| teamplateId | String | 必填 | 模板id | ||
| invalidData | Object | 选填 | 无效的数据 | ||
| invalidReportUrls | List[Object] | 选填 | 无效的链接列表 | ||
| url | String | 选填 | 链接 | ||
| desc | String | 选填 | 无效原因 | ||
| invalidPhones | List[Object] | 选填 | 无效的手机号列表 | ||
| phone | String | 选填 | 无效的手机号 | ||
| desc | String | 选填 | 无效原因 | ||
| invalidCombinePhones | List[Object] | 选填 | 无效的组合号码 | ||
| combinePhone | Object | 选填 | 无效的手机号 | ||
| desc | String | 选填 | 无效原因 | ||
文档更新时间: 2025-11-07 14:03 作者:王超