Complaints API
最新更新:2023-08-10
When users report spam emails, their email addresses will be added to the spam complaint list.
In this list, email addresses will be intercepted by the system, and the delivery status will be classified as "Invalid Email - In SendCloud Blacklist: Bounced (worker: address in complaint list)."
You can query and delete email addresses from the list.
Query
URL
https://email.api.engagelab.cc/v1/complaints
https://email.api.engagelab.cc/v1/complaints
このコードブロックはフローティングウィンドウ内に表示されます
HTTP Request Method
GET
GET
このコードブロックはフローティングウィンドウ内に表示されます
Query Parameter Description
Parameter | Type | Required or not | Description |
---|---|---|---|
start_date | string | * | Start date (format: yyyy-MM-dd) |
end_date | string | * | End date (format: yyyy-MM-dd) |
string | * | Email address, e.g, 22@gmail.com |
|
offset | int | no | Start position [0-], defaults to 0 |
limit | int | no | Amount [0-100], defaults to 100 |
Request Example:
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'
このコードブロックはフローティングウィンドウ内に表示されます
Returned Value Description
Parameter | Description |
---|---|
Complaint email address | |
reason | Complaint reason |
complaint_time | Timestamp of when the complaint occurred |
expire_time | Expiration time for complaint interception |
Returned Value Example
{
"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
}
このコードブロックはフローティングウィンドウ内に表示されます
Delete
URL
https://email.api.engagelab.cc/v1/complaints
https://email.api.engagelab.cc/v1/complaints
このコードブロックはフローティングウィンドウ内に表示されます
HTTP Request Method
DELETE
DELETE
このコードブロックはフローティングウィンドウ内に表示されます
Body Parameter Description
Parameter | Type | Required or not | Description |
---|---|---|---|
start_date | string | * | Start date (format: yyyy-MM-dd) |
end_date | string | * | End date (format: yyyy-MM-dd) |
string | * | Email addresse to delete |
Request Example
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'
このコードブロックはフローティングウィンドウ内に表示されます
Returned Value Description None
Returned Value Example
{
"count": 2
}
{
"count": 2
}
このコードブロックはフローティングウィンドウ内に表示されます