退信地址

由特定原因(如地址不存在等)被退信的邮件会进入此列表.

在此列表中的邮件地址, 会被系统拦截，失败分类为无效邮件-在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
email	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

注意:

1. 获取数据时, 必须指定时间区间. 即 startDate 与 endDate 的组合 或者 days 参数 需二者取一.
2. 此接口只返回自己账号下，曾经发送过的退信地址。SendCloud 黑名单拦截时，是按照全平台的退信地址来进行查询而拦截的。
3. 每次查询默认只查询100条记录，如果用户查询满足条件的记录数超过100时候，需要人为指定start和limit参数.
4. email 为选填参数，当不填时，为批量拉取退信地址；当填时，查询该地址在退信列表中的详情。

请求示例:

https://api.sendcloud.net/apiv2/bounce/list?apiUser=***&apiKey=***&email=***

返回值说明

参数	说明
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
  }