SY-P10-1.0.013
API: newVision/batchxsend - 批量發(fā)送
概覽
newVision/batchxsend
是 SUBMAIL 的5G新視通群發(fā) API 。
newVision/batchxsend
提供完整且強(qiáng)大的群發(fā)發(fā)送功能,解決開發(fā)者在應(yīng)用場景中的群發(fā)營銷信息的需求,具有極大的 API 并發(fā)效率。
URL
https://api-v4.mysubmail.com/newVision/batchxsend
支持格式
格式 | URL |
---|---|
json | https://api-v4.mysubmail.com/newVision/batchxsend.json (默認(rèn)) |
xml | https://api-v4.mysubmail.com/newVision/batchxsend.xml |
yaml | https://api-v4.mysubmail.com/newVision/batchxsend.yaml |
http 請求方式
請求方式 | content-type設(shè)置 |
---|---|
http post | multipart/form-data 、x-www-form-urlencoded 、application/json |
是否需要授權(quán)
是
參閱 API 授權(quán)和驗(yàn)證機(jī)制
請求參數(shù)
參數(shù) | 類型 | 必需/可選 | 默認(rèn) | 描述 |
---|---|---|---|---|
appid | string | 必需 | 無 | 在 SUBMAIL 應(yīng)用集成中創(chuàng)建的彩信應(yīng)用 ID |
project | string | 必需 | 無 | 模板標(biāo)記(ID) |
to | string | 必需 | 無 | 聯(lián)系人手機(jī)號集合,多個(gè)號碼用半角英文逗號分隔,單次提交最大支持1000個(gè)號碼 示例:15212345678,18600000000,19911112222 |
tag | string | 可選 | 無 | 自定義標(biāo)簽功能,該標(biāo)簽可用作SUBHOOK追蹤(32 個(gè)字符以內(nèi)) |
timestamp | UNIX 時(shí)間戳 | 可選 | 無 | 參閱 API 授權(quán)與驗(yàn)證機(jī)制 > Timestamp UNIX 時(shí)間戳 |
sign_type | string | 可選 | normal | API 授權(quán)模式,可選參數(shù): sha256 、md5 、sha1 、normal <br/>參閱 API 授權(quán)與驗(yàn)證機(jī)制 > 授權(quán)和驗(yàn)證方式 |
signature | string | 必需 | 無 | 應(yīng)用密匙或數(shù)字簽名 參閱 API授權(quán)與驗(yàn)證機(jī)制 > 授權(quán)和驗(yàn)證方式 |
代碼示例
發(fā)送一封測試短信
POST URL
https://api-v4.mysubmail.com/newVision/batchxsend
POST DATA
appid=your_appid&project=ThJBE4&signature=your_app_key&to=15212345678
返回
{
"status": "success",
"total_fee": 0.35,
"responses": [
{
"status": "success",
"to": "15212345678",
"send_id": "00ad714ae189439b6c4f8482cee29004",
"fee": 0.35
}
]
}
請求失敗
{
"status": "error",
"code": 252,
"msg": "Incorrect recipient message address, if you are using the addressbook model, this addressbook does not have any contacts"
}
注:如果聯(lián)系人地址中包含多個(gè)聯(lián)系人,接口只會(huì)返回請求成功的聯(lián)系人列表