API de quejas

Última actualización：hace más de 2 años

Cuando los usuarios marcan correos como spam, sus direcciones de correo electrónico se añadirán a la lista de quejas por spam.

En esta lista, las direcciones de correo electrónico serán interceptadas por el sistema y el estado de entrega se clasificará como "Invalid Email - In SendCloud Blacklist: Bounced (worker: address in complaint list)."

Se pueden consultar y eliminar direcciones de correo electrónico de la lista.

Dirección de la solicitud

Centro de datos	URL
Singapur	https://email.api.engagelab.cc
Turquía	https://emailapi-tr.engagelab.com

Al utilizar la API REST, se debe asegurar de que el centro de datos seleccionado corresponda a la URL base adecuada.

POST/v1/complaints

Consultar

URL

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

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

Este bloque de código se muestra en una ventana flotante

Método de solicitud HTTP

GET

GET

Este bloque de código se muestra en una ventana flotante

Descripción de parámetros de consulta

Parámetro	Tipo	Obligatorio	Descripción
start_date	string	*	Fecha de inicio (formato: yyyy-MM-dd)
end_date	string	*	Fecha de fin (formato: yyyy-MM-dd)
email	string	*	Dirección de correo electrónico, p. ej., `22@gmail.com`
offset	int	no	Posición inicial [0-], valor predeterminado: 0
limit	int	no	Cantidad [0-100], valor predeterminado: 100

Ejemplo de solicitud:

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'

Este bloque de código se muestra en una ventana flotante

Descripción de valores devueltos

Parámetro	Descripción
email	Dirección de correo electrónico de la queja
reason	Motivo de la queja
complaint_time	Marca de tiempo de la queja
expire_time	Fecha de caducidad de la intercepción por queja

Ejemplo de valores devueltos

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

Este bloque de código se muestra en una ventana flotante

Eliminar

URL

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

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

Este bloque de código se muestra en una ventana flotante

Método de solicitud HTTP

DELETE

              
              DELETE

Este bloque de código se muestra en una ventana flotante

Descripción de parámetros del cuerpo

Parámetro	Tipo	Obligatorio	Descripción
start_date	string	*	Fecha de inicio (formato: yyyy-MM-dd)
end_date	string	*	Fecha de fin (formato: yyyy-MM-dd)
email	string	*	Dirección de correo electrónico a eliminar

Ejemplo de solicitud

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'

Este bloque de código se muestra en una ventana flotante

Descripción de valores devueltos
Ninguno

Ejemplo de valores devueltos

{ "count": 2 }

              
              {
  "count": 2
}

Este bloque de código se muestra en una ventana flotante