API Keluhan

Terakhir diperbarui：2023-08-10

Ketika pengguna melaporkan email sebagai spam, alamat email mereka akan masuk ke daftar keluhan spam.

Alamat pada daftar ini akan dicegat oleh sistem, dan status pengiriman akan dikategorikan sebagai "Email Tidak Valid - Dalam Daftar Hitam SendCloud: Ditolak (worker: alamat dalam daftar keluhan)."

Anda dapat melakukan pencarian dan menghapus alamat email dari daftar ini.

Alamat Endpoint

Data Center	URL
Singapura	https://email.api.engagelab.cc
Turki	https://emailapi-tr.engagelab.com

Saat menggunakan REST API, pastikan data center yang dipilih sesuai dengan base URL yang digunakan.

POST /v1/complaints

Pencarian

URL

https://email.api.engagelab.cc/v1/complaints

              
              https://email.api.engagelab.cc/v1/complaints

Tampilkan blok kode ini di jendela mengambang

Metode HTTP Request

GET

GET

Tampilkan blok kode ini di jendela mengambang

Deskripsi Parameter Query

Parameter	Tipe	Wajib	Deskripsi
start_date	string	*	Tanggal mulai (format: yyyy-MM-dd)
end_date	string	*	Tanggal akhir (format: yyyy-MM-dd)
email	string	*	Alamat email, misal `22@gmail.com`
offset	int	tidak	Posisi awal [0-], default 0
limit	int	tidak	Jumlah [0-100], default 100

Contoh Permintaan:

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'

Tampilkan blok kode ini di jendela mengambang

Deskripsi Nilai Balik

Parameter	Deskripsi
email	Alamat email yang dikomplain
reason	Alasan keluhan
complaint_time	Waktu terjadinya keluhan
expire_time	Waktu kedaluwarsa pencegatan keluhan

Contoh Nilai Balik

{ "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
}

Tampilkan blok kode ini di jendela mengambang

Hapus

URL

https://email.api.engagelab.cc/v1/complaints

              
              https://email.api.engagelab.cc/v1/complaints

Tampilkan blok kode ini di jendela mengambang

Metode HTTP Request

DELETE

              
              DELETE

Tampilkan blok kode ini di jendela mengambang

Deskripsi Parameter Body

Parameter	Tipe	Wajib	Deskripsi
start_date	string	*	Tanggal mulai (format: yyyy-MM-dd)
end_date	string	*	Tanggal akhir (format: yyyy-MM-dd)
email	string	*	Alamat email yang akan dihapus

Contoh Permintaan

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'

Tampilkan blok kode ini di jendela mengambang

Deskripsi Nilai Balik

Parameter	Deskripsi
count	Jumlah data yang dihapus

Contoh Nilai Balik

{ "count": 2 }

              
              {
  "count": 2
}

Tampilkan blok kode ini di jendela mengambang