垃圾舉報
最新更新: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
}
此代碼塊在浮窗中顯示