添加模版

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/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://yourreceiveurl_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返回值示例(国内短信模板):

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