邮件接口须知

支持版本

无论是免费版还是付费版，EmailCar都支持用户使用邮件API接口。区别在于付费版用户使用的投递通道是独立并且进行过相关备案的，投递效果更好，并发能力更强。免费版用户使用共享通道根据历史投递情况分配不同信誉的共享通道，在投递时效和并发能力上相对付费版来说要差一些，但是基本使用是一样的。

申请接口

注册并激活EmailCar后，进入系统在左侧导航栏中选择“邮件营销”-“触发邮件”，点击页面中的“申请您的邮件API接口”按钮提交后台审核。审核通过后，就可以开始通过接口进行调用发送邮件。

注意事项

1. API接口调用的用户名密码就是登陆EmailCar的用户名密码；

2. 接口一次性提交邮件最多50封；

3. 接口每秒钟只能提交1次；

4. 接口支持WebAPI和SMTP两种方式调用，建议用WebAPI，SMTP获取的统计数据比较单一；

5. 接口提交的邮件内容只允许是事务性内容，对于营销类型内容系统会根据收件人阅读情况进行选择性给予开放；

6. 如果遇到用户被大量收件人具备为垃圾邮件，系统将自动关闭账户使用权限。

触发发送

URL

HTTP请求方式

参数说明

返回 JSON格式

请求，返回值示例

curl -d 'api_user=***&api_pwd=***&[email protected]&fromname=Emailcar&[email protected];[email protected]&subject=欢迎使用Emailcar&html=Emailcar为您服务！' http://webapi.emailcar.net/v1/mail/send
# 失败返回值 ( 如用户名或密码错误 )
{
    "msg": "用户名或密码错误",
    "status": "error"
}
#成功返回值
{
    "data": {
        "return": {
            "id": 873216184254383362
        }
    },
    "msg": "邮件发送成功",
    "status": "success"
}

数据统计概况

URL

HTTP请求方式

参数说明

返回 JSON格式

请求，返回值示例

curl -d 'api_user=***&api_pwd=***&start_date=2012-01-01&end_date=2012-01-02' http://webapi.emailcar.net/v1/mail/stats
#失败返回值 (如用户名或密码错误) 
{
    "msg": "用户名或密码错误",
    "status": "error"
}
#成功返回值 
{
    "data": {
        "total": {
            "failure": 84,
            "request": 436,
            "success": 352
        }
    },
    "msg": "数据成功获取",
    "status": "success"
}

成功返回值说明

发送数据详情

URL

HTTP请求方式

参数说明

返回 JSON格式

请求，返回值示例

curl -d 'api_user=***&api_pwd=***&start_date=2012-01-01&end_date=2012-01-02' http://webapi.emailcar.net/v1/mail/lists
# 失败返回值 ( 如数据为空错误 )
{
    "msg": "没有找到数据",
    "status": "error"
}
# 成功返回值
{
    "data": {
        "0": {
            "failure_msg": "",
            "from": "[email protected]",
            "fromname": "EmailCar会员中心",
            "guest_agent": "",
            "guest_count": "0",
            "guest_ip": "",
            "replyto": "[email protected]",
            "send_time": "2015-11-17 15:29:51",
            "status": "2",
            "subject": "yjy111用户提交了一个任务((AD)【活动最后三天！】反法西斯纪念币免费领【包邮】知识啤酒无限畅饮！！)待审核"
            },
            "return": {
              "id": 873216184254383362
            }
        },
        "1": {
            "failure_msg": "",
            "from": "[email protected]",
            "fromname": "EmailCar会员中心",
            "guest_agent": "",
            "guest_count": "0",
            "guest_ip": "",
            "replyto": "[email protected]",
            "send_time": "2015-11-17 15:45:13",
            "status": "2",
            "subject": "yangpudianzi用户提交了一个任务(广州阳普邀您参加11月27日物联网最新技术体验及红酒品酒会)待审核"
        }
    },
    "msg": "邮件发送成功",
    "status": "success"
}

成功返回值说明

查询余额

URL

HTTP请求方式

参数说明

返回 JSON格式