超鏈接變量 @link(key_name)
概覽
超鏈接變量可以動(dòng)態(tài)地控制郵件模板中的超鏈接。（郵件模板是指你在 SUBMAIL 的 MAIL 應(yīng)用中，使用 SUBMAIL EDITOR 創(chuàng)建的觸發(fā)郵件模板，@link(key_name) 允許你通過(guò) mail/send 和 mail/xsend API 發(fā)送郵件時(shí)，動(dòng)態(tài)地控制郵件中的超鏈接。）
適用 API
| 接口 | 描述 |
|---|---|
| mail/send | 郵件API |
| SMTP API | 郵件 API |
| mail/xsend | 郵件 API |
格式
@link(自定義的變量名)
創(chuàng)建變量
在 SUBMAIL EDITOR 中創(chuàng)建郵件，在需要?jiǎng)討B(tài)控制的超鏈接的位置點(diǎn)擊彈出超鏈接對(duì)話框后，將此超鏈接的協(xié)議設(shè)為“變量”類型，在右側(cè) URL 輸入框中，輸入 @link(key name)，點(diǎn)擊確定，此超鏈接變量將被創(chuàng)建。
在文本上添加超鏈接變量：
在 SUBMAIL EDITOR 中單擊要?jiǎng)?chuàng)建此變量的文本框，使其進(jìn)入文本編輯模式;
選中要?jiǎng)?chuàng)建鏈接的文本后，點(diǎn)擊
按鈕;
在彈出的超鏈接對(duì)話框中，將協(xié)議改為變量;
在 URL 輸入框中鍵入變量 （例 @link(key_name);
此方法同樣適用于在文本變量中創(chuàng)建超鏈接變量。
在圖片上添加超鏈接變量：
在 SUBMAIL EDITOR 中選中要?jiǎng)?chuàng)建超鏈接變量的欄，此時(shí)，此欄中的圖片左側(cè)底部將顯示超鏈接按鈕;
點(diǎn)擊按鈕，進(jìn)入超鏈接對(duì)話框;
在彈出的超鏈接對(duì)話框中，將協(xié)議改為變量;
在 URL 輸入框中鍵入變量 （例 @link(key_name);
請(qǐng)注意：如果你使用 HTML CODE 模式在 SUBMAIL EDITOR 中創(chuàng)建的郵件模板，你需要在使用這些超鏈接變量的位置之前加上 var:// 來(lái)標(biāo)示此鏈接的協(xié)議。
例：文本
此變量不支持純文本郵件。
使用變量
在你使用 mail/xsend API 發(fā)送時(shí)，請(qǐng)以json字符串（key:value）方式連接你的變量 e.g. {"key":"value","key":"value"}，并將此字符串放在 links 參數(shù)中提交。
注：例中的 key 表示你設(shè)定的變量名，value 表示你想替換此變量的超鏈接（超鏈接必須包含完整的 http 協(xié)議，http:// , https:// 或 ftp://）
使用示例
例：如果你在郵件中創(chuàng)建了超鏈接變量，變量為 @link(verification)
如下：
在 links 參數(shù)中將 links={”verification”:”http://submail.cn/chs/account/verification?code=nX6U81”} 提交至 SUBMAIL，用戶收到的郵件如下：
當(dāng)用戶點(diǎn)擊立即驗(yàn)證按鈕后，將進(jìn)行驗(yàn)證。
請(qǐng)注意：links 參數(shù)要求嚴(yán)格的 JSON 格式，以下是將參數(shù)轉(zhuǎn)換為 JSON 格式的注意事項(xiàng)
- json 字符串必須以雙引號(hào)包含
- json 字符串必須是 utf8 編碼
- 不能有多余的逗號(hào) 如：[1,2,]
- json 字符串首尾必須被大括號(hào){}包含
PS:大多數(shù)的語(yǔ)言都有專屬的JSON解析器（ ENCODING 和 DECODEING 方法）。如 PHP，首先將需要的變量以數(shù)組形式(如 $var[‘key’]=value) 創(chuàng)建后，使用 json_encode($var)方法創(chuàng)建 JSON 字符串；