退信地址
由特定原因(如地址不存在等)被退信的邮件会进入此列表.
在此列表中的邮件地址, 会被系统拦截,失败分类为无效邮件-在SendCloud黑名单中:退信(worker:address in bounce list)
你可以对此列表进行查询操作
查询
URL
https://api.sendcloud.net/apiv2/bounce/list
HTTP请求方式
post get
参数说明
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
apiUser | string | 是 | API_USER |
apiKey | string | 是 | API_KEY |
string | 否 | 查询该地址在退信列表中的详情 | |
days | string | * | 过去 days 天内的投递数据,(days=1表示今天) |
startDate | string | * | 开始日期, 格式为yyyy-MM-dd |
endDate | string | * | 结束日期, 格式为yyyy-MM-dd |
start | string | 否 | 查询起始位置, 取值区间 [0-], 默认为 0 |
limit | int | 否 | 查询个数, 取值区间 [0-100], 默认为 100 |
注意:
- 获取数据时, 必须指定时间区间. 即 startDate 与 endDate 的组合 或者 days 参数 需二者取一.
- 此接口只返回自己账号下,曾经发送过的退信地址。SendCloud 黑名单拦截时,是按照全平台的退信地址来进行查询而拦截的。
- 每次查询默认只查询100条记录,如果用户查询满足条件的记录数超过100时候,需要人为指定start和limit参数.
- email 为选填参数,当不填时,为批量拉取退信地址;当填时,查询该地址在退信列表中的详情。
请求示例:
https://api.sendcloud.net/apiv2/bounce/list?apiUser=***&apiKey=***&email=***
返回值说明
参数 | 说明 |
---|---|
邮件地址 | |
reason | 退信原因 |
bounceTime | 退信的发生时间 |
expireTime | 过期时间 |
domain | 退信域名 |
返回值示例
{
"statusCode":200,
"info":{
"dataList":[
{
"email":"b@qq.com",
"reason":"Mailbox not found. http://service.mail.qq.com/cgi-bin/help?subtype=1&&id=20022&&no=1000728",
"bounceTime":"2021-06-28 08:59:34",
"domain":"qq.com",
"expireTime": "2021-07-09 00:59:37"
}
],
"count":1
}
"message":"请求成功",
"result":true
}