垃圾举报
最新更新:2023-08-10
用户举报的垃圾邮件, 此用户的地址会进入垃圾举报列表。
在此列表中的邮件地址在达到过期时间之前, 都不会再被发送邮件。
你可以对此列表进行查询、删除操作。
查询
URL
https://email.api.engagelab.cc/v1/complaints
https://email.api.engagelab.cc/v1/complaints
此代码块在浮窗中显示
HTTP 请求方式
GET
GET
此代码块在浮窗中显示
查询参数说明
参数 | 类型 | 是否必需 | 说明 |
---|---|---|---|
start_date | string | * | 开始日期(格式:yyyy-MM-dd) |
end_date | string | * | 结束日期(格式:yyyy-MM-dd) |
string | * | 邮件地址,例如,22@gmail.com |
|
offset | int | 否 | 起始位置 [0-],默认为 0 |
limit | int | 否 | 数量 [0-100],默认为 100 |
请求示例:
curl -X GET -H 'Content-Type: application/json; charset=utf-8'
-H 'Authorization:Basic YXBpX3VzZXI6YXBpX2tleQ=='
'https://email.api.engagelab.cc/v1/complaints?offset=0&limit=90'
curl -X GET -H 'Content-Type: application/json; charset=utf-8'
-H 'Authorization:Basic YXBpX3VzZXI6YXBpX2tleQ=='
'https://email.api.engagelab.cc/v1/complaints?offset=0&limit=90'
此代码块在浮窗中显示
返回值描述
参数 | 描述 |
---|---|
查询该地址在举报列表中的详情 | |
reason | 举报原因 |
complaint_time | 举报发生时间 |
expire_time | 举报到期时间 |
返回值示例
{
"result": [
{
"email": "9978977@qq.com",
"reason": "from softbounce",
"complaint_time": "2016-02-01T14:53:20+0800",
"expire_time": "2017-02-01T14:53:20+0800"
}
],
"count": 1,
"total": 1
}
{
"result": [
{
"email": "9978977@qq.com",
"reason": "from softbounce",
"complaint_time": "2016-02-01T14:53:20+0800",
"expire_time": "2017-02-01T14:53:20+0800"
}
],
"count": 1,
"total": 1
}
此代码块在浮窗中显示
删除
URL
https://email.api.engagelab.cc/v1/complaints
https://email.api.engagelab.cc/v1/complaints
此代码块在浮窗中显示
HTTP 请求方式
DELETE
DELETE
此代码块在浮窗中显示
请求参数说明
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
start_date | string | * | 开始日期(格式:yyyy-MM-dd) |
end_date | string | * | 结束日期(格式:yyyy-MM-dd) |
string | * | 删除指定邮件 |
请求示例
curl -X DELETE -H 'Content-Type: application/json; charset=utf-8'
-H 'Authorization:Basic YXBpX3VzZXI6YXBpX2tleQ=='
--data '{"email": "x@example.com"}'
'https://email.api.engagelab.cc/v1/complaints'
curl -X DELETE -H 'Content-Type: application/json; charset=utf-8'
-H 'Authorization:Basic YXBpX3VzZXI6YXBpX2tleQ=='
--data '{"start_date": "2023-04-01 08:00:00", "end_date": "2023-07-01 08:00:00"}'
'https://email.api.engagelab.cc/v1/complaints'
curl -X DELETE -H 'Content-Type: application/json; charset=utf-8'
-H 'Authorization:Basic YXBpX3VzZXI6YXBpX2tleQ=='
--data '{"email": "x@example.com"}'
'https://email.api.engagelab.cc/v1/complaints'
curl -X DELETE -H 'Content-Type: application/json; charset=utf-8'
-H 'Authorization:Basic YXBpX3VzZXI6YXBpX2tleQ=='
--data '{"start_date": "2023-04-01 08:00:00", "end_date": "2023-07-01 08:00:00"}'
'https://email.api.engagelab.cc/v1/complaints'
此代码块在浮窗中显示
返回值说明
无
返回值示例
{
"count": 2
}
{
"count": 2
}
此代码块在浮窗中显示