添加模版


HTTP 头信息:


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


请求


URL:`https://sms.yunpian.com/v2/tpl/add.json`
注意:海外服务器地址 us.yunpian.com
访问方式:POST


请求参数


特别说明:
验证码类模板必填参数websitetplType

参数名类型是否必须描述示例
apikeystring

用户唯一标识,在账号设置-子帐号管理中查看

9b11127a9701975c734b8aee81ee3526
tpl_contentstring模板内容,必须以带符号【】的签名开头【云片网】您的验证码是#code#
notify_typeinteger审核结果短信通知的方式。其中:
0 表示需要通知,默认;
1 表示仅审核不通过时通知;
2 表示仅审核通过时通知;
3 表示不需要通知;
1
websitestring验证码类模板对应的官网注册页面,验证码类模板必填https://www.yunpian.com/entry?method=register
tplTypeinteger1 代表验证码类模板,验证码类模板必填1
callbackstring审核结果会向这个地址推送http://your_receive_url_address
apply_descriptionstring说明模板的发送场景和对象用于向云片注册用户发送验证码短信


callback 推送参数举例,您需要 post 方式接收数据,推送的数据格式为表单

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


响应

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


Json 返回值示例(国内短信模板):


{
  "tpl_id": 1,
  "tpl_content": "【云片网】您的验证码是#code#",
  "check_status": "CHECKING",
  "reason": null
}