发送统计

获取发送统计信息

URL

http://www.bestedm.net/mm-ms/apinew/stask.php

HTTP请求方式

GET

备注：该接口平台创建任务发送和smtp对接发送均适用

参数说明

参数	类型	必须	说明
date	string (YYYY-MM-DD)	*	统计开始日期. 举例: `2020-06-12`
date_end	string (YYYY-MM-DD)	*	统计结束日期. 举例: `2020-06-22`. 当参数date和date_end都有设置，则获取该时间范围的统计数据，但如果只传一个，只获取当前传那天的数据
ident	string	*	任务批次号. 举例: `20200615134441-2369-93`
id	int	*	任务ID, 参数ident和id只要传一个即可

注意:

可以只传时间信息，不传任务，表示获取所传时间内所有任务信息
由于某些任务是跨多天完成的，如想获取该任务完整发送数据，只要传任务信息，不要传时间信息

API 返回的结果是 XML 格式, 示例如下:

<?xml version="1.0" encoding="UTF-8"?>
<data>
<task>
<task_id>统计报表主键,并非真正任务id</task_id>
<task_date>日期</task_date>
<task_ident>任务批次</task_ident>
<totalsum>预计总发送量</totalsum>
<total>发送量</total>
<invalid>无效地址和投诉、格式等未发送错误量</invalid>
<failed>总投递失败量包括发送失败和拒绝发送的數量</failed>
<send_failed>总发送失败的數量</send_failed>
<success>投递发送成功数</success>
<email_not_exist>邮箱不存在數</email_not_exist>
<spam_content>垃圾内容数</spam_content>
<connect_error>连接错误數</connect_error>
<actual>实际扣点数 </actual>
<over_quota>空间不足</over_quota>
<user_reject>用户拒收</user_reject>
<rubbish>判为垃圾邮件拒绝发送的数量</rubbish>
<point>任务当天扣点数</point>
<rebate>返点数</rebtae>
</task>
...
</data>

导出发送失败地址

URL

http://www.bestedm.net/mm-ms/apinew/failexport.php

HTTP请求方式

GET

备注：该接口 api 和平台操作、smtp 对接方式均适用，但是 smtp 对接方式无法准确获取指定批次无效地址，请悉知，若要获取无效地址，请务必不传 task_id 和 task_ident，按照日期获取,或者使用 http://www.bestedm.net/mm-ms/apinew/statistic.php?date=yyyy-mm-dd 接口获取

参数说明

参数	类型	必须	说明
date	string (YYYY-MM-DD)	*	(非必要参数，date，date_end,task_id,task_ident 必传其一即可) 开始日期：所要导出失败地址批次任务的开始日期（date，date_end 有一个为空表示指定为当前日期）例：2012-03-02，不要传入 2012-3-2，必须格式是 YYYY-MM-dd
date_end	string (YYYY-MM-DD)	*	(非必要参数，date，date_end,task_id,task_ident 必传其一即可) 结束日期：所要导出失败地址批次任务的结束日期（date，date_end 有一个为空表示指定为当前日期）
task_id	string	*	(非必要参数，date，date_end,task_id,task_ident 必传其一即可) 指定统计任务的 task_id，非发送任务的任务 id(send_id), 而是根据 send_id 调用【获取指定群发任务的跟踪统计概览】获取返回的 task_id(请特别注意)
task_ident	string	*	(非必要参数，date，date_end,task_id,task_ident 必传其一即可) 指定的任务批次号，就是获取该次任务批次相关的任务的错误地址记录。type 参数为 1,2,3 时，task_id 或者 task_ident 其一是必要参数
type	int	是	错误地址类型, 取值分别表示： 1 或 "not_exist": 邮箱不存在； 2 或 "over_quota": 邮箱空间满； 3 或 "user_reject": 用户拒收 4：垃圾内容邮件 5: 拒绝投递 6：地址是黑名单，收件人黑名单 7：投诉地址 9 或 "format_error": 格式错误； 8 或 "invalid_addr": 无效地址； 10：连接异常 -1 或 "all":全部错误失败无效拒收等地址
out_type	string	否	输出格式, 取值file(默认),json,xml

输出格式：

默认直接输出文本文件，每行一个邮件地址。当 out_type 为空取 file，json， xml 分别表示导出 json，xml 格式数据。 file 导出 csv；

xml 结果返回示例：

    <?xml version="1.0" encoding="UTF-8"?>
<fail_recipient_list>
<recipient>
<email>violatte@coolreall.com</email>
<error_type>1</error_type>
<error_type_dec>邮箱不存在</error_type_dec>
</recipient>
...
</fail_recipient_list>
    

Json 结果返回示例：

    [
"1595936793@qq.com",
"1595936793@qq.com", …
]
    

详细发送日志查询

URL

http://www.bestedm.net/mm-ms/apinew/maillog.php

HTTP请求方式

GET

参数说明

参数	类型	必须	说明
date	string (YYYY-MM-DD)	是	查询日期. 举例: `2020-06-12`
mail_to	string	是	邮件收件人, 必须是完整的邮件地址
task_ident	string	否	任务标识

注意:

该接口每天有调用次数限制，具体在网页上查看

API 返回的结果是 Json 格式, 示例如下:

{"lists": [
    {
       "mail_from": "发件人",
       "mail_to": "收件人",
       "size": "邮件大小"
       "task_ident": "任务批次",
       "code": 返回码,
       "send_time": "发送时间",
       "detail": "发送详细信息",
       "reason/suggestion": "原因/建议",
    },
]}