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

注冊送短信

API: MMS/MultiXSend - 彩信模板一對多發(fā)送


概覽


MMS/multixsend 是 SUBMAIL 的彩信通知一對多（即1條API請求發(fā)送多個號碼，并可以靈活控制每個聯(lián)系人的文本變量）和群發(fā) API 。

MMS/multixsend 提供完整且強(qiáng)大的彩信發(fā)送功能，MMS/multixsend 解決開發(fā)者在應(yīng)用場景中的一對多或群發(fā)的需求，極大的提高 API 并發(fā)效率。

使用方法與 MMS/xsend 相似，不同的是 MMS/multixsend 去除了 to 和 vars 參數(shù)將其整合到 multi 參數(shù)中，可以將聯(lián)系人的手機(jī)號碼，和不同的文本變量整合，實(shí)現(xiàn)一對多場景中靈活控制文本變量的功能。


開發(fā)者們可在提交 MMS/multixsend API 時，將 to 和 vars 參數(shù)編碼為 JSON 字符串格式添加到 multi 參數(shù)中提交，multi 參數(shù)的數(shù)據(jù)模型請參考以下示例：

multi=[{
        "to":"15*********",
        "vars":{
            "name":"kevin",
            "code":123456
        }
    },{
        "to":"18*********",
        "vars":{
            "name":"jacky",
            "code":236554
        }
    },{
        "to":"13*********",
        "vars":{
            "name":"tom",
            "code":236554
        }]



完整的 MMS/multixsend POST 請求請參考以下示例：

appid=your_app_id
project=EM9sd
multi=[{
    "to":"15*********",
    "vars":{
        "name":"kevin",
        "code":123456
    }
},{
    "to":"18*********",
    "vars":{
        "name":"jacky",
        "code":236554
    }
},{
    "to":"13*********",
    "vars":{
        "name":"tom",
        "code":236554
    }]
signature=your_app_key


URL


https://api-v4.mysubmail.com/mms/multixsend


支持格式


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


http 請求方式


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


是否需要授權(quán)


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


請求參數(shù)


參數(shù)類型必需/可選默認(rèn)描述
appidstring必需無在 SUBMAIL 應(yīng)用集成中創(chuàng)建的彩信應(yīng)用 ID
projectstring必需無模板標(biāo)記（ID）
multijson string必需無收件人 to 聯(lián)系人參數(shù)和 vars 文本變量的整合模式，請將 to 和 vars 整合成 json字符串格式提交（數(shù)據(jù)模型請參考本頁概覽頁面提交打multi參數(shù)示例）
tagstring可選無自定義標(biāo)簽功能，該標(biāo)簽可用作SUBHOOK追蹤（32 個字符以內(nèi)）
timestampUNIX 時間戳可選無參閱 API 授權(quán)與驗(yàn)證機(jī)制 > Timestamp UNIX 時間戳
sign_typestring可選normalAPI 授權(quán)模式（ md5 or sha1 or normal ）
參閱 API 授權(quán)與驗(yàn)證機(jī)制 > 授權(quán)和驗(yàn)證方式
sign_versionstring可選1signature加密計算方式(當(dāng)sign_version傳2時，multi參數(shù)不參與加密計算)
signaturestring必需無應(yīng)用密匙或數(shù)字簽名
參閱 API授權(quán)與驗(yàn)證機(jī)制 > 授權(quán)和驗(yàn)證方式


代碼示例


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


POST URL
https://api-v4.mysubmail.com/mms/multixsend.json


POST DATA
appid=your_app_id
&project=ThJBE4
&multi=[{
    "to":"15*********",
    "vars":{
        "name":"kevin",
        "code":123456
        }
    },{
    "to":"18*********",
    "vars":{
        "name":"jacky",
        "code":236554
        }
    }]
&signature=your_app_key


返回
[
    {
        "status": "success",
        "to": "153xxxxxxx",
        "send_id": "398164866e2e43b7569b09de7f091ca6",
        "fee": 0.18
    },
    {
        "status": "success",
        "to": "191xxxxxxxx",
        "send_id": "6ac3208ee91047286277e6251d97340b",
        "fee": 0.18
    }
]


返回值


請求成功
[
    {
        "status": "success",
        "to": "153xxxxxxx",
        "send_id": "398164866e2e43b7569b09de7f091ca6",
        "fee": 0.18
    },
    {
        "status": "success",
        "to": "191xxxxxxxx",
        "send_id": "6ac3208ee91047286277e6251d97340b",
        "fee": 0.18
    }
]


請求失敗
[
    {
        "status": "success",
        "to": "153xxxxxxxx",
        "send_id": "4fc1bc42215a4ff167aaa3bea8cf5b75",
        "fee": 0.18
    },
    {
        "status": "error",
        "code": 252,
        "msg": "Incorrect recipient message address"
    }
]


注：mms/multixsend API 中返回碼將包含成功和失敗的狀態(tài) ，API 在一條API中發(fā)起對多個號碼的請求，所以返回狀態(tài)也是按多條API計算的，例如：單次請求中包含3個聯(lián)系人，其中2個聯(lián)系人請求成功，1個聯(lián)系人請求失敗時，此時的API返回狀態(tài)，將包含3條狀態(tài)數(shù)組（即2條 status:success ，1條 status:error 的狀態(tài)）


錯誤代碼


參閱 API 錯誤代碼