SUBMAIL发邮件API接⼝-Mailsend
API: Mail/send
概览
mail/send 是 SUBMAIL 的邮件 API。 mail/send API 不仅提供强⼤的邮件发送功能, 并在 API 中集成了地址簿发送功能。你可以通过设定⼀些参数来确定 API 以哪种模式发送。
mail/send API 可以使⽤变量动态的控制每封邮件的内容。 了解如何使⽤和。
URL
<；主> submail/mail/send
<；备> api.submail/mail/send
⽀持格式
格式URL
json submail/mail/send.json（默认）
xml submail/l
http 请求⽅式
请求⽅式content-type设置
http post multipart/form-data、x-www-form-urlencoded、application/json
是否需要授权
是
参阅
请求参数
参数类型
必
需/
可
选
默认描述
appid string文章出轨姚笛
必
需
小蛮腰歌词完整版⽆在 SUBMAIL 应⽤集成中创建的邮件应⽤ID
to string 可
选
⽆
收件⼈地址 (多个联系⼈⽤半⾓“,”隔开： e.g. "leo <leo>, <retro>, service@submail"，单次请求提交邮箱数
量控制在100个以内，SUBMAIL ⽀持完整的 RFC 822 收件⼈标准，请确保您的邮件地址的有效性。请参见维
基百科)
from
e-
mail
必
需
⽆发件⼈地址 ，标准的发件⼈地址 e.g. leo@submail
from_name string 可
选
⽆发件⼈称呼，显⽰名称 e.g. Submail （50个字符以内）
reply
e-
mail
可
选
⽆回复地址(标准的回复邮件地址 e.g. leo@submail)
cc string 可
选
⽆抄送地址 (多个抄送地址请⽤ “ , ”_半⾓逗__号_区分，请将抄送联系⼈控制在 5 个以内)。
bcc string 可
选
⽆密送地址(多个密送地址请⽤ “ ,”_半⾓逗__号_或区分，请将密送联系⼈控制在 5 个以内)。
subject string
必
需
⽆邮件标题（200个字符以内）
text string 可
选
⽆纯⽂本邮件正⽂（5000个字符以内）
html string 可
茄子煲选
⽆HTML 邮件正⽂（60 KB以内）
vars
json
string
可
选
⽆使⽤⽂本变量动态控制邮件中的⽂本，参阅
links
json
string
可
选
⽆使⽤超链接变量动态控制邮件中的超链接，参阅
attachments⽂件可
选顺风快递电话号码
⽆附件（⽂件数量不超过10个，⽂件总⼤⼩应⼩于5 MB，此参数不参与加密计算）
atta
json
array
可
选qq空间制作
⽆
附件 base64格式⽂件附件，eg: atta= [{“name”:“测试.zip”,“data”:“base64”},
{“name”:“2”,“data”:“base64 file”},…]（atta参数可⽤于base64格式的附件传输，此参数为jason
array格式，每组数据需包含 name 和 data 参数，name 为⽂件名，data 为 附件的base 64数据；⽂件数
量不超过10个，⽂件总⼤⼩应⼩于5 MB，此参数不参与加密计算 ）
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
时间戳
可
选
⽆参阅 > Timestamp UNIX 时间戳
sign_type string 可
选
normal
API 授权模式（ md5 or sha1 or normal ）
参阅 > 授权和验证⽅式
sign_version string 可
选
⽆
signature加密计算⽅式(当sign_version传2时，text，html，vars，links，attachments参数不参与加密
计算)
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
submail/mail/send.json
POST DATA
appid=your_app_id
&to=leo <leo>
&subject=testing_Subject
&text=testing_text_body
&from=no-reply@submail
&signature=your_app_key
返回
{
"status":"success",
"return": [
{
"send_id": "HstDN4",
"to": "eg@eg"
}
]
}
发送⼀封测试邮件，多收件⼈
POST URL
submail/mail/send.json2022乌拉圭阵容太豪华
POST DATA
appid=your_app_id
&to=leo <leo>,retro@submail
&subject=testing_Subject
&text=testing_text_body
&from=no-reply@submail
&signature=your_app_key
返回
{
"status":"success",
"return": [
{
"send_id": "HstDN4",
"to": "eg@eg"
}
]
}
使⽤地址簿发送⼀封测试邮件
POST URL
submail/mail/send.json
POST DATA
appid=your_app_id
&addressbook=subscribe
&subject=testing_Subject
&text=testing_text_body
&from=no-reply@submail
&signature=your_app_key
返回
{
"status":"success",
"return": [
{
"send_id": "HstDN4",
"to": "eg@eg"
}
]
}
发送⼀封带附件的测试邮件
POST URL
submail/mail/send.json
POST DATA
appid=your_app_id
&to=leo <leo>,retro@submail
&subject=testing_Subject
&text=testing_text_body
&from=no-reply@submail
&attachments[]=/path/
&signature=your_app_key
返回
{
"status":"success",
"return": [
{
"send_id": "HstDN4",
"to": "eg@eg"
}
]
}
使⽤CURL发送⼀封测试邮件
发送 CURL
curl -d 'appid=your_app_id&to=leo<leo> &subject=testing Subject&text=testing text body&from=no-reply@submail&signature=y our_app_key' submail/mail/send.json
返回
{
"status":"success",
"return": [
{
"send_id": "HstDN4",
"to": "eg@eg"
}
]
}
使⽤CURL发送⼀封测试邮件，多收件⼈
发送 CURL
curl -d 'appid=your_app_id&to=leo<leo> ,retro@submail&subject=testing Subject&text=testing text body&from=no-reply@submail &signature=your_app_key' submail/mail/send.json
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论