а√在线中文网新版地址在线,播五月开心婷婷综合,午夜国产精品视频在线,√8天堂资源地址中文在线,80岁色老头oldmanvideos

注冊(cè)送短信

API: SMS/UnionSend - 國(guó)內(nèi)短信與國(guó)際短信聯(lián)合發(fā)送


概覽


sms/unionsend 是 SUBMAIL 的國(guó)內(nèi)短信與國(guó)際短信聯(lián)合發(fā)送 API,sms/unionsend 結(jié)合了國(guó)內(nèi)短信和國(guó)際短信的發(fā)送接口,對(duì)不同國(guó)家的監(jiān)管政策執(zhí)行不同的發(fā)送策略,在單一接口實(shí)現(xiàn)全球化短信發(fā)送功能;



URL


https://api-v4.mysubmail.com/sms/unionsend


支持格式


格式URL
jsonhttps://api-v4.mysubmail.com/sms/unionsend.json(默認(rèn))
xmlhttps://api-v4.mysubmail.com/sms/unionsend.xml
yamlhttps://api-v4.mysubmail.com/sms/unionsend.yaml


http 請(qǐng)求方式


請(qǐng)求方式content-type設(shè)置
postmultipart/form-data、x-www-form-urlencoded、application/json
get


是否需要授權(quán)


參閱 API 授權(quán)和驗(yàn)證機(jī)制

請(qǐng)注意:sms/unionsend 接口僅支持 normal 明文 驗(yàn)證模式,暫不支持 MD5/SHA1/SHA256 模式



請(qǐng)求參數(shù)


參數(shù)類型必需/可選默認(rèn)描述
appidstring必需無(wú)國(guó)內(nèi)短信 AppID
signaturestring必需無(wú)國(guó)內(nèi)短信應(yīng)用密鑰(Appkey)
inter_appidstring必須無(wú)國(guó)際短信 AppID
inter_signaturestring必須無(wú)國(guó)際短信應(yīng)用密鑰(Appkey)
tostring必需無(wú)收件人手機(jī)號(hào)碼,該API僅支持一對(duì)一模式(即單條API請(qǐng)求僅能發(fā)送一個(gè)聯(lián)系人),該參數(shù)現(xiàn)在僅能提交一個(gè)位聯(lián)系人。
注:國(guó)際號(hào)段請(qǐng)使用標(biāo)準(zhǔn)的 E164 格式,e.g. +1778889901; 國(guó)內(nèi)短信可直接使用11位國(guó)內(nèi)手機(jī)號(hào)碼進(jìn)行發(fā)送, 國(guó)內(nèi)號(hào)段同樣支持 +86138xxxxx 格式
contentstring必需無(wú)短信正文
(正文中必須提交有效的短信簽名,且您的短信簽名必須放在短信的最前端,e.g.【SUBMAIL】您的短信驗(yàn)證碼:4438,請(qǐng)?jiān)?0分鐘內(nèi)輸入。
content 參數(shù)將會(huì)與您賬戶中的短信模板進(jìn)行匹配,如無(wú)匹配 API會(huì)創(chuàng)建一個(gè)短信模板并提交到人工審核,審核通過(guò)后下次提交相似短信(內(nèi)容達(dá)到一定匹配度)則不會(huì)觸發(fā)人工審核直接進(jìn)行下發(fā),如審核失敗則第二次請(qǐng)求返回 420 錯(cuò)誤,審核失敗會(huì)觸發(fā)SUBHOOK中模板template_reject事件
請(qǐng)將短信正文控制在 1000 個(gè)字符以內(nèi)。)
inter_contentstring可選無(wú)國(guó)際短信正文,當(dāng)發(fā)送為國(guó)際短信時(shí)(非+86),優(yōu)先使用該參數(shù)中傳遞的正文;如該參數(shù)為空則使用 content 參數(shù)作為短消息正文進(jìn)行發(fā)送;
intersms_verify_code_transformstring (true or false)可選無(wú)是否提取短消息正文 content 參數(shù)中的驗(yàn)證碼(數(shù)字 4 - 10 位),替換 inter_content 中的 @var(code) 變量;
要使用該功能,請(qǐng)?jiān)?code>inter_content 傳遞國(guó)際短信的正文,并將驗(yàn)證碼變量設(shè)置為 @var(code)
<u>eg . your verify code is : @var(code)</u>
tagstring可選無(wú)自定義標(biāo)簽功能,該標(biāo)簽可用作SUBHOOK追蹤
(32 個(gè)字符以內(nèi),添加了 tag 參數(shù)的 API 請(qǐng)求,會(huì)在所有的 SUBHOOK 事件中攜帶此參數(shù)。tag 參數(shù)不參加加密計(jì)算)


代碼示例


發(fā)送一封測(cè)試短信


POST URL
https://api-v4.mysubmail.com/sms/unionsend.json


POST DATA
appid=your_app_id
&signature=your_app_key
&inter_appid=your_international_sms_appid
&inter_signature=your_international_sms_signature
&to=+86138xxxxxxxx
&content=【SUBMAIL】您的短信驗(yàn)證碼:4438,請(qǐng)?jiān)?0分鐘內(nèi)輸入。
&intersms_verify_code_transform=true
&inter_content=[SUBMAIL] your verify code is : @var(code)


返回
{
    "status": "success",
    "send_id": "c2f0e679ad8dxxxxxf6cb71bf2925665e0",
    "fee": 1,
}


使用 CURL 發(fā)送一封測(cè)試短信


發(fā)送 CURL
curl -d '
appid=your_app_id&signature=your_app_key
&inter_appid=your_international_sms_appid
&inter_signature=your_international_sms_signature
&to=+852981xxxxxxx
&content=【SUBMAIL】您的短信驗(yàn)證碼:4438,請(qǐng)?jiān)?0分鐘內(nèi)輸入。
&intersms_verify_code_transform=true
&inter_content=[SUBMAIL] your verify code is : @var(code)
' https://api-v4.mysubmail.com/sms/unionsend.json


返回
{
    "status": "success",
    "send_id": "c2f0e679ad8dxxxxxf6cb71bf2925665e0",
    "fee": 0.397
}


返回值


請(qǐng)求成功
{
    "status": "success",
    "send_id": "c2f0e679ad8dxxxxxf6cb71bf2925665e0",
    "fee": 1
}


請(qǐng)求失敗
{
      "status":"error",
      "code":"1xx",
      "msg":"error sms"
}


錯(cuò)誤代碼


參閱 API 錯(cuò)誤代碼