API: Mail/XSend - 郵件模板發(fā)送

概覽

mail/xsend 是郵件 API 的升級版本。與 mail/send API 一樣，mail/xsend 提供強大的郵件發(fā)送功能，區(qū)別于 mail/send API，mail/xsend 無需提交 html 源碼或郵件文本內(nèi)容，甚至無需提交郵件標題或發(fā)件人，僅需提交你在 SUBMAIL MAIL 中創(chuàng)建的郵件項目模板ID，并可以使用變量動態(tài)的控制每封郵件的內(nèi)容。


項目模版ID：

了解如何使用文本變量和超鏈接變量。


使用 mail/xsend API 你將可以使用 SUBMAIL 編輯器 高效、可視化地創(chuàng)建你的觸發(fā)郵件，無需管理郵件中的一切靜態(tài)資源或編碼（如圖片，html 代碼兼容等問題），甚至移動設(shè)備兼容問題，SUBMAIL 編輯器 已為你做好了一切。

URL

https://api-v4.mysubmail.com/mail/xsend

支持格式

http 請求方式

是否需要授權(quán)

是

參閱 API 授權(quán)和驗證機制

請求參數(shù)

注意：

Submail 保留 x-submail-smtp-api 指令，請務(wù)必不要在郵件標頭中使用此指令

自定義的 EMAIL headers 指令通常以字母 X- 開頭，請將此規(guī)范應(yīng)用到你的指令

vars,  links 和 headers 參數(shù)要求嚴格的 JSON 格式，以下是將參數(shù)轉(zhuǎn)換為 JSON 格式的注意事項

json 字符串必須以雙引號包含
json 字符串必須是 utf8 編碼
不能有多余的逗號 如：[1,2,]
json 字符串首尾必須被大括號{}包含 
 
PS:大多數(shù)的語言都有專屬的JSON解析器（ ENCODING 和 DECODEING 方法）。如 PHP，首先將需要的變量以數(shù)組形式(如 $var[‘key’]=value) 創(chuàng)建后，使用 json_encode($var)方法創(chuàng)建 JSON 字符串；

代碼示例

發(fā)送一封測試郵件

POST URL

https://api-v4.mysubmail.com/mail/xsend.json

POST Data

appid=your_app_id
&to=leo@submail.cn
&project=ThJBE4
&signature=your_app_key

返回

{
    "status": "success",
    "return": [
        {
            "to": "leo@submail.cn",
            "send_id": "e6243d12875942204e757a08c6487e24"
        }
    ]
}

發(fā)送一封測試郵件，多收件人

POST URL

https://api-v4.mysubmail.com/mail/xsend.json

POST DATA

appid=your_app_id
&to=leo@submail.cn,retro@submail.cn
&project=ThJBE4
&signature=your_app_key

返回

{
    "status": "success",
    "return": [
        {
            "send_id": "adda40cbd0f226c92960e70662859efe",
            "to": "leo@submail.cn"
        },
        {
            "send_id": "850a4d5022c47aeab18d466575555f0e",
            "to": "retro@submail.cn"
        }
    ]
}

使用 CURL 發(fā)送一封測試郵件

發(fā)送 CURL

curl -d 'appid=your_app_id&to=leo@submail.cn&project=ThJBE4&signature=your_app_key' https://api-v4.mysubmail.com/mail/xsend.json

返回

{
    "status": "success",
    "return": [
        {
            "to": "leo@submail.cn",
            "send_id": "e6243d12875942204e757a08c6487e24"
        }
    ]
}

使用 CURL 發(fā)送一封測試郵件,多收件人

發(fā)送 CURL

curl -d 'appid=your_app_id&to=leo@submail.cn,retro@submail.cn&&project=ThJBE4&signature=your_app_key' https://api-v4.mysubmail.com/mail/xsend.json

返回

{
    "status": "success",
    "return": [
        {
            "send_id": "adda40cbd0f226c92960e70662859efe",
            "to": "leo@submail.cn"
        },
        {
            "send_id": "850a4d5022c47aeab18d466575555f0e",
            "to": "retro@submail.cn"
        }
    ]
}

請求成功

{
    "status": "success",
    "return": [
        {
            "to": "leo@submail.cn",
            "send_id": "e6243d12875942204e757a08c6487e24"
        }
    ]
}

請求失敗

{
      "status":"error",
      "code":"1xx",
      "msg":"error message"
}

錯誤代碼

參閱 [API 錯誤代碼](