添加模版
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`
注意:海外服務(wù)器地址 us.yunpian.com
訪問方式:POST
請求參數(shù)
特別說明:
驗(yàn)證碼類模板必填參數(shù)website
、tplType
、apply_description
參數(shù)名 | 類型 | 是否必須 | 描述 | 示例 |
apikey | string | 是 | 用戶唯一標(biāo)識,在賬號設(shè)置-子帳號管理中查看 | 9b11127a9701975c734b8aee81ee3526 |
tpl_content | string | 是 | 模板內(nèi)容,必須以帶符號【】的簽名開頭 | 【云片網(wǎng)】您的驗(yàn)證碼是#code# |
notify_type | integer | 否 | 審核結(jié)果短信通知的方式。其中: | 1 |
website | string | 否 | 驗(yàn)證碼類模板對應(yīng)的官網(wǎng)注冊頁面,驗(yàn)證碼類模板必填 |
|
tpl_type | integer | 否 | 1 代表驗(yàn)證碼類模板,驗(yàn)證碼類模板必填; 0 代表通知類模板; (僅適用于系統(tǒng)子號,營銷子號無需傳此參數(shù),默認(rèn)都是營銷類模板) | 1 |
callback | string | 否 | 審核結(jié)果會(huì)向這個(gè)地址推送 |
|
apply_description | string | 否 | 說明模板的發(fā)送場景和對象,驗(yàn)證碼類模板必填 | 用于向云片注冊用戶發(fā)送驗(yàn)證碼短信 |
callback 推送參數(shù)舉例,您需要 post 方式接收數(shù)據(jù),推送的數(shù)據(jù)格式為表單
名稱 | 類型 | 描述 |
tpl_id | string | 模板 id |
tpl_content | string | 模板內(nèi)容 |
check_status | string | //審核狀態(tài):CHECKING/SUCCESS/FAIL |
reason | string | 審核未通過的原因 |
響應(yīng)
名稱 | 類型 | 描述 |
tpl_id | string | 模板 id |
tpl_content | string | 模板內(nèi)容 |
check_status | string | //審核狀態(tài):CHECKING/SUCCESS/FAIL |
reason | string | 審核未通過的原因 |
Json 返回值示例(國內(nèi)短信模板):
{
"tpl_id": 1,
"tpl_content": "【云片網(wǎng)】您的驗(yàn)證碼是#code#",
"check_status": "CHECKING",
"reason": null
}