修改模版

注意:模板成功修改之后需要重新审核才能使用!同时提醒您如果修改了变量,请重新务必测试,以免替换出错!

HTTP头信息:

  1. Accept:application/json;charset=utf-8;
  2. Content-Type:application/x-www-form-urlencoded;charset=utf-8;

请求

URL:https://sms.yunpian.com/v2/tpl/update.json

注意:海外服务器地址 us.yunpian.com

访问方式:POST

请求参数

参数名类型是否必须描述示例
apikeyString用户唯一标识9b11127a9701975c734b8aee81ee3526
tpl_idlong模板id,64位长整形,指定id时返回id对应的模板。未指定时返回所有模板9527
tpl_contentString模板id,64位长整形。指定id时返回id对应的模板。未指定时返回所有模板模板内容,必须以带符号【】的签名开头【云片网】您的验证码是#code#
langString国际短信模板所需参数,模板语言:简体 中文zh_cn; 英文en; 繁体中文 zh_tw; 韩文ko,日文 ja; 其他语言 other (其他语言功能需联系在线客服开通)zh_cn
callbackstring审核结果会向这个地址推送,推送参数如下http://yourreceiveurl_address

callback推送参数举例

名称类型描述
tpl_idstring模板id
tpl_contentstring模板内容
check_statusstring//审核状态:CHECKING/SUCCESS/FAIL
reasonstring审核未通过的原因

响应

名称类型描述
tpl_idstring模板id
tpl_contentstring模板内容
check_statusstring//审核状态:CHECKING/SUCCESS/FAIL
reasonstring审核未通过的原因
langstring支持语言
country_codestring支持地区

Json响应示例:

情况1: 修改国际短信模板但未修改语言(带参数lang但lang参数不变) 或 把国内短信模板修改为国际短信模板(带参数lang)):

  1. {
  2. "tpl_id": 9527,
  3. "tpl_content": "【云片网】您的验证码是#code#",
  4. "check_status": "CHECKING",
  5. "reason": null,
  6. "lang": "ko",
  7. "country_code": "KR"
  8. }

情况2:修改了国际短信模板的语言,即lang参数改变):

  1. {
  2. "code": 0,
  3. "msg": "OK",
  4. "template": {
  5. "tpl_id": 9527,
  6. "tpl_content": "【云片网】您的验证码是#code#",
  7. "check_status": "CHECKING",
  8. "reason": null,
  9. "lang": "ja",
  10. "country_code": "JP"
  11. }
  12. }

情况3:国际短信模板修改为国内短信模板,不带lang参数):

  1. {
  2. "msg": "OK",
  3. "template": {
  4. "tpl_id": 9527,
  5. "tpl_content": "【云片网】您的验证码是#code#",
  6. "check_status": "CHECKING",
  7. "reason": null
  8. }
  9. }

语言支持说明:

语言代码支持地区
英文en全球所有国家地区
中文简体zh_cn大陆CN、台湾TW、香港HK、澳门MO
中文繁体zh_tw大陆CN、台湾TW、香港HK、澳门MO、韩国KR
韩文ko韩国KR
日文ja日本JP