Códigos de error

Cómo se informan los errores de API y las respuestas SMTP, y qué hacer en cada caso.

Formato de error de la API

Los errores de la API son JSON con un código estable y un mensaje. Base su lógica en el código y muestre el mensaje solo a las personas, ya que la redacción puede cambiar.

{
  "error": { "code": "invalid_recipient", "message": "The recipient address is not valid." }
}

¿Reintentar o corregir?

Los errores se dividen en dos grupos. Corrija la solicitud: las respuestas 4xx distintas de 429 indican que algo falla en lo que envió, por lo que reintentar fallará igual. Inténtelo más tarde: las respuestas 429 y 5xx son temporales, así que reintente con backoff exponencial y un límite de intentos.

Respuestas SMTP

Las respuestas SMTP empiezan con un código de tres dígitos. 2xx significa éxito. 4xx indica un fallo temporal, por lo que el remitente debe reintentar más tarde. 5xx indica un fallo permanente, así que no reenvíe el mismo mensaje a esa dirección. Muchas respuestas añaden un código mejorado como 5.1.1 que explica la causa.

Cómo leer los motivos de rebote

Los códigos mejorados son la forma más rápida de entender un rebote. 5.1.1 significa que el buzón no existe. 5.2.2 significa que el buzón está lleno. 5.7.1 significa que el servidor receptor rechazó el mensaje por política, a menudo por autenticación o reputación. Los códigos 4.x.x son temporales y se reintentarán.

Qué hacer con los rebotes

Elimine de su lista las direcciones con rebote duro e investigue los rechazos por política revisando su configuración de SPF, DKIM y DMARC. Una tasa de rebote creciente daña su reputación, así que actúe pronto.