文本變量 @var(key_name)
概覽
文本變量可以動(dòng)態(tài)的控制郵件或郵件模板中的文本內(nèi)容，文本變量同樣可以動(dòng)態(tài)的控制短信中的內(nèi)容。（郵件模板是指你在 SUBMAIL 的 MAIL 應(yīng)用中，使用 SUBMAIL EDITOR 創(chuàng)建的觸發(fā)郵件模板）
適用 API
| 接口 | 描述 |
|---|---|
| mail/send | 郵件 API |
| mail/xsend | 郵件 API |
| SMTP API | 郵件 API |
| sms/xsend | 短信 API |
格式
@var(自定義的變量名)
創(chuàng)建變量
在 SUBMAIL EDITOR 中創(chuàng)建郵件，在需要?jiǎng)討B(tài)控制的文本位置鍵入 @var(key_name)，你可以使用文本編輯器的樣式來(lái)編輯此變量的顯示位置、樣式、顏色、字體或字體大小等。SUBMAIL API 在輸出此變量時(shí)，將完整的繼承這些顯示屬性。
使用變量
在你使用 API 發(fā)送時(shí)，請(qǐng)以 json 字符串（key:value）方式連接你的變量 e.g. {”key”:”value”,”key”:”value”}，并將此字符串放在 vars 參數(shù)中提交。
注：例中的 key 表示你設(shè)定的變量名，value 表示你想替換此變量的文本
例：如果你在郵件中創(chuàng)建了 3 個(gè)變量，分別為 @var(title) , @var(username) , @var(number)，如下：
在 vars 參數(shù)中將 vars={"username":"Leo","title":"6月份郵件訂閱報(bào)告","number":"300"} 提交至 SUBMAIL，用戶收到的郵件如下：
請(qǐng)注意：vars 參數(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 字符串；