对接邮件群发平台的PHP代码示例

邮件发送接口

https://api.wayincloud.com/mail/send

https://api.wayincloud.com/mail/xsend

https://api.wayincloud.com/mail/multisend

https://api.wayincloud.com/mail/multixsend

请求方式

post

参数说明

–xsend

参数 必需/可选 类型 描述
appid 必需 string 邮件应用id
to 必需 string 收件人邮箱
sign_type 可选 string 可选类型md5,sha1,normal
timestamp 可选 unix时间戳 该参数需要从wayincloud服务器获取
signature 必需 string 接口鉴权参数，请参考 《接口安全机制》
from 必需 string 发件人邮箱
from_name 可选 string 发件人姓名
reply 必需 string 回复邮箱
cc 可选 string 抄送地址，多个抄送地址请用英文半角逗号分开，最多可支持5个抄送地址
bcc 可选 string 密送地址 多个密送地址请使用英文版叫逗号分开，最多可支持5个密送地址
project 必需 string 项目id
attachments 可选 file 附件，支持多个附件，附件大小总和不超过10m
vars 可选 json string 文本变量参数，详细可参考 《变量与内置变量》 文档
links 可选 json string 超链接变量参数，详细可参考 《变量与内置变量》 文档
headers 可选 json string 自定义 email 头文件指令，headers是一个标准的字符串，支持开发者在邮件的标头中插入自定义指令，不超过500字符
tag 可选 string 自定义标签追踪，可用于subhook追踪
subject 必需 string 邮件标题，标题长度不大于100

–send

参数 必需/可选 类型 描述
appid 必需 string 邮件应用id
to 必需 string 收件人邮箱
sign_type 可选 string 验证方式,可选类型md5,sha1,normal
timestamp 可选 unix时间戳 该参数需要从wayincloud服务器获取
signature 必需 string` 接口鉴权参数，请参考 《接口安全机制》
from 必需 string 发件人邮箱
from_name 可选 string 发件人姓名
reply 必需 string 回复邮箱
cc 可选 string 抄送地址，多个抄送地址请用英文半角逗号分开，最多可支持5个抄送地址
bcc 可选 string 密送地址 多个密送地址请使用英文版叫逗号分开，最多可支持5个密送地址
subject 必需 string 邮件标题，标题长度不大于100
vars 可选 json string 文本变量参数，详细可参考 《变量与内置变量》 文档
links 可选 json string 超链接变量参数，详细可参考 《变量与内置变量》 文档
headers 可选 json string 自定义 email 头文件指令，headers是一个标准的字符串，支持开发者在邮件的标头中插入自定义指令，不超过500字符
tag 可选 string 定义标签追踪，可用于subhook数据追踪
attachments 可选 file 附件，支持多个附件，附件大小总和不超过10m
html 与text参数二选一 html
text 与html参数二选一 text

–multixsend

参数 必需/可选 类型 描述
appid 必需 string 邮件应用id
sign_type 可选 string 验证方式,可选类型md5,sha1,normal
timestamp 可选 unix时间戳 该参数需要从wayincloud服务器获取
signature 必需 string 接口鉴权参数，请参考 《接口安全机制》
from 必需 string 发件人邮箱
from_name 可选 string 发件人姓名
reply 必需 string 回复邮箱
cc 可选 string 抄送地址，多个抄送地址请用英文半角逗号分开，最多可支持5个抄送地址
bcc 可选 string 密送地址 多个密送地址请使用英文版叫逗号分开，最多可支持5个密送地址
subject 必需 string 邮件标题，标题长度不大于100
multi 必需 json string 收件人参数结构体 map数组 [{“to”:"",vars:{“code”:“123”},links:{“url”:“https://www.wayincloud.com”}},{…},{…}]
headers 可选 json string 自定义 email 头文件指令，headers是一个标准的字符串，支持开发者在邮件的标头中插入自定义指令，不超过500字符
tag 可选 string 定义标签追踪，可用于subhook数据追踪
attachments 可选 file 附件，支持多个附件，附件大小总和不超过10m
project 必需 string 项目id

–multisend

参数 必需/可选 类型 描述
appid 必需 string 邮件应用id
sign_type 可选 string 验证方式,可选类型md5,sha1,normal
timestamp 可选 unix 时间戳 参数需要从wayincloud服务器获取
signature 必需 string 接口鉴权参数，请参考 《接口安全机制》
from 必需 string 发件人邮箱
from_name 可选 string 发件人姓名
reply 必需 string 回复邮箱
cc 可选 string 抄送地址，多个抄送地址请用英文半角逗号分开，最多可支持5个抄送地址
bcc 可选 string 密送地址 多个密送地址请使用英文版叫逗号分开，最多可支持5个密送地址
subject 必需 string 邮件标题，标题长度不大于100
multi 必需 json string 收件人参数结构体 map数组 [{“to”:"",vars:{“code”:“123”},links:{“url”:“https://www.wayincloud.com”}},{…},{…}]
headers 可选 json string 自定义 email 头文件指令，headers是一个标准的字符串，支持开发者在邮件的标头中插入自定义指令，不超过500字符
tag 可选 string 定义标签追踪，可用于subhook数据追踪
attachments 可选 file 附件，支持多个附件，附件大小总和不超过10m
html 与text参数二选一 html
text 与html参数二选一 text

multi参数说明

to 必需参数 收件人

vars 可选 无变量该参数可以忽略

links 可选 无变量该参数可以忽略

代码示例

PHP

<?php $curl = curl_init(); $post_data = array( ​ "appid" => "10000", ​ "signature" => "ffec737c202e0f7ef3c04b684afebe46", ​ "project" => "adHct1", ​ "to" => "service@wayincloud.com", ​ "from" => "admin@wayincm.net", ​ "vars" => '{"code":"12345"}', ​ "subject" => "wayincloud email subject", ); curl_setopt_array($curl, array( ​ CURLOPT_URL => "https://api.wayincloud.com/mail/xsend", ​ CURLOPT_RETURNTRANSFER => true, ​ CURLOPT_MAXREDIRS => 10, ​ CURLOPT_TIMEOUT => 30, ​ CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, ​ CURLOPT_CUSTOMREQUEST => "POST", ​ CURLOPT_POSTFIELDS => $post_data, ​ CURLOPT_HTTPHEADER => array("content-type:multipart/form-data"), )); $response = curl_exec($curl); $err = curl_error($curl); $curl_close($curl); if($err){ ​ echo $err; }else{ ​ echo $response; } ?>

状态码示例

请求成功

send/xsend

{

“status”:“success”,

“send_id”:“ffec737c202e0f7ef3c04b684afebe46”,

“to”:“service@wayincloud.com”

}

multisend/multixsend

[{

“status”:“success”,

“send_id”:“ffec737c202e0f7ef3c04b684afebe46”,

“to”:“service@wayincloud.com”

}, {

“status”:“success”,

“send_id”:“ffec737c202e0f7ef3c04b684afebe46”,

“to”:“service@wayincloud.com”

}, {

“status”:“success”,

“send_id”:“ffec737c202e0f7ef3c04b684afebe46”,

“to”:“service@wayincloud.com”

}]
请求失败

{

“status”:“error”,

“code”:“110”,

“msg”:“invalid appid”

}