Delivery Response
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/email_status
Consulta
Lista de estados de correo electrónico.
Se puede consultar el estado de los correos electrónicos en esta lista.
URL
https://email.api.engagelab.cc/v1/email_status
https://email.api.engagelab.cc/v1/email_status
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
Encabezado de la solicitud
| Encabezado | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Authorization | String | true | Basic base64(api_user:api_key) |
Descripción de parámetros de consulta
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| offset | string | No | Posición inicial, [0-], valor predeterminado: 0 |
| limit | int | No | Cantidad, [0-100], valor predeterminado: 100 |
| send_date | string | Sí | El formato de la fecha de envío es yyyy-MM-dd |
| string | No | Dirección del destinatario | |
| email_ids | string | No | Se devolverá emailId tras enviar un correo electrónico correctamente mediante la API; las direcciones se separan por punto y coma; p. ej., email_ids=a;b;c |
| api_user | string | No | Nombre de api_user |
| domain_name | string | No | Dominio receptor; por ejemplo: gmail.com |
| label_id | string | No | ID de etiqueta correspondiente a la etiqueta creada |
| status | string | No | Estado. El valor del estado de envío es 18; el valor del estado entregado es 1; el valor del estado de rebote suave es 5; el valor del estado de correo no válido es 4. |
| sub_status | string | No | Varios sub_status, separados por punto y coma; p. ej., sub_status=a;b;c. Cuando se proporciona este parámetro, el parámetro status no es válido. |
Consejos:
- El valor predeterminado es 100 registros por cada búsqueda. Se debe especificar limit y offset si los registros superan 100.
- Cada registro de consulta se almacenará en caché durante 10 minutos.
- Esta interfaz limita las llamadas de cada cuenta de usuario a 60 por minuto. Si esto no satisface sus necesidades, utilice WebHook.
- Si se proporciona el parámetro email, se pueden consultar los detalles de entrega de la dirección correspondiente dentro de los 30 días posteriores a send_date. Si no se proporciona el parámetro email, solo se pueden consultar los detalles de datos de send_date.
| sub_status | Descripción del sub_status |
|---|---|
| 401 | Correo no válido - Lista negra |
| 402 | Correo no válido - Baja |
| 403 | Correo no válido - Error del servidor |
| 404 | Correo no válido - Error de formato |
| 405 | Correo no válido - Rechazo de IP |
| 406 | Correo no válido - No existe |
| 407 | Correo no válido - Correo no deseado |
| 408 | Correo no válido - Rechazado |
| 409 | Correo no válido - Otros |
| 503 | Rebote suave - Error del servidor |
| 505 | Rebote suave - Rechazo de IP |
| 506 | Rebote suave - No existe |
| 507 | Rebote suave - Rechazo por spam |
| 508 | Rebote suave - Rechazado |
| 509 | Rebote suave - Otros |
Ejemplo de solicitud:
curl "https://email.api.engagelab.cc/v1/email_status?send_date=2022-11-21&email_ids=***;***" --header "Authorization: Basic <<YOUR_API_KEY_HERE>>"
curl "https://email.api.engagelab.cc/v1/email_status?send_date=2022-11-21&email_ids=***;***" --header "Authorization: Basic <<YOUR_API_KEY_HERE>>"
Este bloque de código se muestra en una ventana flotante
Descripción de los valores devueltos
| Campo | Descripción |
|---|---|
| Dirección del destinatario | |
| email_id | Se devolverá emailId tras enviar un correo electrónico correctamente mediante la API |
| api_user | Nombre de api_user |
| status | Estado del correo electrónico |
| status_desc | Descripción del estado |
| sub_status | Código de estado no válido (401-509) |
| sub_status_desc | Descripción de la subclase de no válido o rebote suave |
| request_time | Hora de solicitud |
| update_time | Hora de actualización |
| response_message | Respuesta |
Ejemplo de valores devueltos
{
"result": [
{
"email_id": "1668065941982_15_2032_7460.sc-10_2_226_96-test0$1720f4a1d6af047181@hotmail.com",
"api_user": "zymtest4",
"email": "1720f4a1d6af047181@hotmail.com",
"request_time": "2022-11-10T15:39:01+0800",
"update_time": "2022-11-10T17:34:16+0800",
"status": 4,
"sub_status": 409,
"status_desc": "Invalid Email",
"sub_status_desc": "Other",
"response_message": "Other(scheduler: deleted)"
}
],
"total": "48675",
"count": 1
}
{
"result": [
{
"email_id": "1668065941982_15_2032_7460.sc-10_2_226_96-test0$1720f4a1d6af047181@hotmail.com",
"api_user": "zymtest4",
"email": "1720f4a1d6af047181@hotmail.com",
"request_time": "2022-11-10T15:39:01+0800",
"update_time": "2022-11-10T17:34:16+0800",
"status": 4,
"sub_status": 409,
"status_desc": "Invalid Email",
"sub_status_desc": "Other",
"response_message": "Other(scheduler: deleted)"
}
],
"total": "48675",
"count": 1
}
Este bloque de código se muestra en una ventana flotante
