垃圾舉報

最新更新: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)
email 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: 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: YXBpX3VzZXI6YXBpX2tleQ==' 
     'https://email.api.engagelab.cc/v1/complaints?offset=0&limit=90' 

        
此代碼塊在浮窗中顯示

返回值描述

參數 描述
email 查詢該地址在舉報列表中的詳情
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)
email string * 刪除指定郵件

請求示例

curl -X DELETE -H 'Content-Type: application/json; charset=utf-8' -H 'Authorization: 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: 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: 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: 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
}

        
此代碼塊在浮窗中顯示
在文档中心打开