- 修改模版
- 请求
- 请求参数
- 响应
- Json响应示例:
修改模版
注意:模板成功修改之后需要重新审核才能使用!同时提醒您如果修改了变量,请重新务必测试,以免替换出错!
HTTP头信息:
Accept:application/json;charset=utf-8;
Content-Type:application/x-www-form-urlencoded;charset=utf-8;
请求
URL:https://sms.yunpian.com/v2/tpl/update.json
注意:海外服务器地址 us.yunpian.com
访问方式:POST
请求参数
参数名 | 类型 | 是否必须 | 描述 | 示例 |
---|---|---|---|---|
apikey | String | 是 | 用户唯一标识 | 9b11127a9701975c734b8aee81ee3526 |
tpl_id | long | 是 | 模板id,64位长整形,指定id时返回id对应的模板。未指定时返回所有模板 | 9527 |
tpl_content | String | 是 | 模板id,64位长整形。指定id时返回id对应的模板。未指定时返回所有模板模板内容,必须以带符号【】的签名开头 | 【云片网】您的验证码是#code# |
lang | String | 是 | 国际短信模板所需参数,模板语言:简体 中文zh_cn; 英文en; 繁体中文 zh_tw; 韩文ko,日文 ja; 其他语言 other (其他语言功能需联系在线客服开通) | zh_cn |
callback | string | 否 | 审核结果会向这个地址推送,推送参数如下 | http://yourreceiveurl_address |
callback推送参数举例
名称 | 类型 | 描述 |
---|---|---|
tpl_id | string | 模板id |
tpl_content | string | 模板内容 |
check_status | string | //审核状态:CHECKING/SUCCESS/FAIL |
reason | string | 审核未通过的原因 |
响应
名称 | 类型 | 描述 |
---|---|---|
tpl_id | string | 模板id |
tpl_content | string | 模板内容 |
check_status | string | //审核状态:CHECKING/SUCCESS/FAIL |
reason | string | 审核未通过的原因 |
lang | string | 支持语言 |
country_code | string | 支持地区 |
Json响应示例:
情况1: 修改国际短信模板但未修改语言(带参数lang但lang参数不变) 或 把国内短信模板修改为国际短信模板(带参数lang)):
{
"tpl_id": 9527,
"tpl_content": "【云片网】您的验证码是#code#",
"check_status": "CHECKING",
"reason": null,
"lang": "ko",
"country_code": "KR"
}
情况2:修改了国际短信模板的语言,即lang参数改变):
{
"code": 0,
"msg": "OK",
"template": {
"tpl_id": 9527,
"tpl_content": "【云片网】您的验证码是#code#",
"check_status": "CHECKING",
"reason": null,
"lang": "ja",
"country_code": "JP"
}
}
情况3:国际短信模板修改为国内短信模板,不带lang参数):
{
"msg": "OK",
"template": {
"tpl_id": 9527,
"tpl_content": "【云片网】您的验证码是#code#",
"check_status": "CHECKING",
"reason": null
}
}
语言支持说明:
语言 | 代码 | 支持地区 |
---|---|---|
英文 | en | 全球所有国家地区 |
中文简体 | zh_cn | 大陆CN、台湾TW、香港HK、澳门MO |
中文繁体 | zh_tw | 大陆CN、台湾TW、香港HK、澳门MO、韩国KR |
韩文 | ko | 韩国KR |
日文 | ja | 日本JP |