SUBMAIL邮件平台API接口-Mail/xsend
API: Mail/xsend
原文链接
概览
mail/xsend 是邮件 API 的升级版本。与 mail/send API 一样，mail/xsend 提供强大的邮件发送功能，区别于 mail/send API，mail/xsend 无需提交 html 源码或邮件文本内容，甚至无需提交邮件标题或发件人，仅需提交你在 SUBMAIL MAIL 中创建的邮件项目模板ID，并可以使用变量动态的控制每封邮件的内容。
项目模版ID：
了解如何使用文本变量和超链接变量。
使用 mail/xsend API 你将可以使用 SUBMAIL 编辑器 高效、可视化地创建你的触发邮件，无需管理邮件中的一切静态资源或编码（如图片，html 代码兼容等问题），甚至移动设备兼容问题，SUBMAIL 编辑器 已为你做好了一切。
URL
<主> https://api.mysubmail.com/mail/xsend
<备> https://api.submail.cn/mail/xsend
支持格式
| 格式 | URL |
|---|---|
json
|
https://api.mysubmail.com/mail/xsend.json（默认）
|
xml
|
https://api.mysubmail.com/mail/xsend.xml
|
http 请求方式
| 请求方式 | content-type设置 |
|---|---|
http post
|
multipart/form-data、x-www-form-urlencoded、application/json
|
是否需要授权
是
参阅 API 授权和验证机制
请求参数
| 参数 | 类型 | 必需/可选 | 默认 | 描述 |
|---|---|---|---|---|
appid
|
string
|
必需
|
无 | 在 SUBMAIL 应用集成中创建的邮件应用ID |
to
|
string
|
可选 | 无 |
收件人地址 (多个联系人用半角“,”隔开：e.g. "leo <leo>, <retro>, service@submail.cn",SUBMAIL 支持完整的 RFC 822 收件人标准，请确保您的邮件地址的有效性。请参见 维基百科 EMAIL ADDRESS RFC822 文档) |
from
|
e-mail
|
必需
|
无 | 发件人地址 ，标准的发件人地址 e.g. leo@submail.cn |
from_name
|
string
|
可选 | 无 | 发件人称呼，显示名称 e.g. Submail （50个字符以内） |
reply
|
e-mail
|
可选 | 无 | 回复地址，标准的回复邮件地址 e.g. leo@submail.cn |
cc
|
string
|
可选 | 无 |
抄送地址 (多个抄送地址请用 “ , ”半角逗__号区分，请将抄送联系人控制在 5 个以内)。 |
bcc
|
string
|
可选 | 无 |
密送地址 (多个密送地址请用 “ ,”半角逗__号或区分，请将密送联系人控制在 5 个以内)。 |
subject
|
string
|
必需
|
无 |
邮件标题（200个字符以内,不提交邮件标题，此标题将读取项目标题)
|
project
|
string
|
可选 | 无 |
项目标记(ID)在SUBMAIL>MAIL>项目中，（如果您的账户已开通应用集成，提交并验证了的开发者身份后）你将可以查看你所创建的邮件项目标记。 此参数将根据你提交的标记来确定该发送的项目。 |
vars
|
json string
|
可选 | 无 | 使用文本变量动态控制邮件中的文本，参阅 了解如何创建和使用文本变量 |
links
|
json string
|
可选 | 无 | 使用超链接变量动态控制邮件中的超链接，参阅 了解如何创建和使用超链接变量 |
headers
|
json string
|
可选 | 无 |
自定义 EMAIL 头文件指令，headers 是一个标准的 JSON 字符串，headers 参数可以让开发者在 EMAIL 的标头部分插入自定义指令（500个字符以内）。 如： {"X-Accept-Language": "zh-cn", "X-Priority":"3","X-Mailer": "My Application"}
|
asynchronous
|
string
|
可选 |
false
|
异步选项，该值设为 true 时启用异步发送模式 |
tag
|
string
|
可选 | 无 | 自定义标签功能，该标签可用作SUBHOOK追踪（32 个字符以内） |
timestamp
|
UNIX 时间戳
|
可选 | 无 |
参阅 API 授权与验证机制 > Timestamp UNIX 时间戳
|
sign_type
|
string
|
可选 |
normal
|
API 授权模式（ md5 or sha1 or normal ）参阅 API 授权与验证机制 > 授权和验证方式
|
sign_version
|
string
|
可选 | 无 | signature加密计算方式(当sign_version传2时，vars，links参数不参与加密计算) |
signature
|
string
|
必需 | 无 | 应用密匙 或 数字签名 |
注意：
Submail 保留 x-submail-smtp-api 指令，请务必不要在邮件标头中使用此指令自定义的 EMAIL headers 指令通常以字母 X- 开头，请将此规范应用到你的指令vars, links 和 headers 参数要求严格的 JSON 格式，以下是将参数转换为 JSON 格式的注意事项json 字符串必须以双引号包含
json 字符串必须是 utf8 编码
不能有多余的逗号 如：[1,2,]
json 字符串首尾必须被大括号{}包含 PS:大多数的语言都有专属的JSON解析器（ ENCODING 和 DECODEING 方法）。如 PHP，首先将需要的变量以数组形式(如 $var[‘key’]=value) 创建后，使用 json_encode($var)方法创建 JSON 字符串；
代码示例
发送一封测试邮件
POST URL
https://api.mysubmail.com/mail/xsend.json
POST Data
appid=your_app_id
&to=leo <leo>
&project=ThJBE4
&signature=your_app_key
返回
{"status":"success","return": [{"send_id": "HstDN4","to": "eg@eg.com"}]
}
发送一封测试邮件，多收件人
POST URL
https://api.mysubmail.com/mail/xsend.json
POST DATA
appid=your_app_id
&to=leo <leo>,retro@submail.cn
&project=ThJBE4
&signature=your_app_key
返回
{"status":"success","return": [{"send_id": "HstDN4","to": "eg@eg.com"}]
}
使用地址簿发送一封测试邮件
POST URL
https://api.mysubmail.com/mail/xsend.json
POST DATA
appid=your_app_id
&addressbook=subscribe
&project=ThJBE4
&signature=your_app_key
返回
{"status":"success","return": [{"send_id": "HstDN4","to": "eg@eg.com"}]
}
使用 CURL 发送一封测试邮件
发送 CURL
curl -d 'appid=your_app_id&to=leo<leo> &project=ThJBE4&signature=your_app_key' https://api.mysubmail.com/mail/xsend.json
返回
{"status":"success","return": [{"send_id": "HstDN4","to": "eg@eg.com"}]
}
使用 CURL 发送一封测试邮件,多收件人
发送 CURL
curl -d 'appid=your_app_id&to=leo<leo> ,retro@submail.cn&&project=ThJBE4&signature=your_app_key' https://api.mysubmail.com/mail/xsend.json
返回
{"status":"success","return": [{"send_id": "HstDN4","to": "eg@eg.com"}]
}
使用 CURL 发送一封测试邮件,使用地址簿中的收件人
发送 CURL
curl -d 'appid=your_app_id&addressbook=subscribe&&project=ThJBE4&signature=your_app_key' https://api.mysubmail.com/mail/xsend.json
返回
{"status":"success","return": [{"send_id": "HstDN4","to": "eg@eg.com"}]
}
返回值
请求成功
{"status":"success","return": [{"send_id": "HstDN4","to": "eg@eg.com"}]
}
请求失败
{"status":"error","code":"1xx","msg":"error message"
}
错误代码
参阅 API 错误代码
SUBMAIL邮件平台API接口-Mail/xsend相关推荐
- SUBMAIL短信平台API接口-Message/xsend
API: Message/xsend 原文链接 概览 message/xsend 是 SUBMAIL 的短信 API 的升级版本. 与 message/send API 一样,message/xsen ...
- 啥？以后找工作面试求职者的将不是人！那是啥？道翰天琼认知智能机器人平台API接口为您揭秘。
啥?以后找工作面试求职者的将不是人!那是啥?道翰天琼认知智能机器人平台API接口为您揭秘. 当你正襟危坐在屏幕前,参加公司视频面试的时候,此时盯着你的不仅是面试官,还有背后一整套 AI 算法. 你的表 ...
- 全球首次！32岁青年科学今天发现！道翰天琼认知智能机器人平台API接口大脑为您揭秘。
全球首次!32岁青年科学今天发现!道翰天琼认知智能机器人平台API接口大脑为您揭秘. 一支中美联合研究团队,在全球首次完成了跨膜孔蛋白的精确从头设计,这些具有不同孔径的跨膜孔蛋白,可以选择性通透不同分 ...
- 有AI就不搬砖？超乎你的想象！道翰天琼认知智能机器人平台API接口大脑为您揭秘。
有AI就不搬砖?超乎你的想象!道翰天琼认知智能机器人平台API接口大脑为您揭秘. AI在化学合成中的应用 李成涛:合成以及逆合成是有机化学中的一个重要命题.逆合成旨在寻找能够合成目标化合物的反应物和合 ...
- 疑惑！AI中台到底为什么火了？道翰天琼认知智能机器人平台API接口为您揭秘。
疑惑!AI中台到底为什么火了?道翰天琼认知智能机器人平台API接口为您揭秘. 自从 2015 年阿里提出 "中台" 战略后,"中台"便成为一个行业热词,许多公司 ...
- AI解梦成为现实 未来还有无限可能道翰天琼认知智能机器人平台API接口大脑为您揭秘
AI解梦成为现实 未来还有无限可能道翰天琼认知智能机器人平台API接口大脑为您揭秘 古代巴比伦人认为梦境包含了预言,而古埃及人则将梦境视为神灵给予的信息来崇拜.在 19 世纪 90 年代,西格蒙德·弗 ...
- 人机融合智能：人工智能3.0。道翰天琼认知智能机器人平台API接口大脑为您揭秘
人机融合智能:人工智能3.0.道翰天琼认知智能机器人平台API接口大脑为您揭秘 摘要:人工智能(客观智能)与人类智能(主观智能)最有可能演变成为一对相生相克的阴阳对立统一体,从而开启一个全新的时代,即 ...
- 淘宝/天猫平台API 接口及API文档
淘宝/天猫平台API 接口平台 item_get - 获得淘宝详情接口 测试地址:https://console.open.onebound.cn/console/index.php?i=Anzexi ...
- 什么是短信平台api接口？
自从人类诞生了手机,短信便随之而来,虽然后来有了更多的即时通信工具,如QQ和微信,个人用短信的机会已经很少了,但是对于企业公司来说,短信一直是非常方便的信息传递工具. 那些带有营销性质的企业和商家会通 ...
最新文章
- Python知识点进阶——生成器
- python画樱桃小丸子的程序_多任务---线程threading使用总结。
- 全网唯一的Microsoft?NETFramework3?5SP1简体中文完整版离线安装包安装netframewo
- 一个1990年代的小故事
- [html] 使用svg画一个爱心
- SpringMVC 应用配置
- 面向小姐姐的编程——JAVA面向对象之继承（三）
- JSONObject与JSONArray的使用
- 计算机网络学习笔记（23. HTTP连接类型）
- PHP学习笔记之PDO
- 图像处理_如何保存浮点型数值的图像？ (C++ / OpenCV)
- Servlet-请求匹配，创建Servlet的三种方式，API 1
- java 日期转大写,java步骤转换大写日期及人民币大写转换方式 .txt
- 纪念半个月的旷课生活~
- 自动焊锡机加锡时的注意事项
- AutoLayout Label 自适应宽高
- maven 设置本地仓库
- （翻译）你想做用户体验经理吗？
- JavaScript 高级3 ：函数进阶
- [新奇周边] 内置2400mAh电量 可以充电的手机壳上市【转载：今日头条】