Registros de peticiones

Email API›Logs registra el tráfico de la API y de SMTP que llega a Emailit con tus claves de API. Cuando un envío falla antes incluso de que se cree un email, por ejemplo por un error de validación o un límite de velocidad, el registro de peticiones es donde ves lo que envió tu código y exactamente lo que respondió Emailit.

Qué se registra

El encabezado de la página lo resume: «Successful and failed API v2 and SMTP requests authenticated with an API key.»

No se registran:

• Las peticiones sin clave de API o con una clave desconocida, porque no se pueden vincular a un espacio de trabajo. Si recibes 401 Invalid API key y aquí no ves nada, comprueba qué clave usa tu código.
• La actividad en el panel ni los comandos AUTH de SMTP que se completan correctamente.

Los valores sensibles se ocultan antes de guardarse. Los campos con nombres como password, secret, token, authorization o api_key, y los valores que parecen claves de API (secret_…) o tokens, se sustituyen por [redacted]. Las cadenas largas se truncan a 16.384 caracteres y los arrays a 50 elementos, así que los adjuntos grandes no aparecen completos.

Encontrar una petición

• Intervalo de tiempo: elige Last 1 hour, Last 6 hours, Last 24 hours (por defecto), Last 72 hours, Last 7 days o Last 30 days, o elige un intervalo de fechas personalizado. También puedes arrastrar sobre el gráfico para ampliar un periodo.
• Gráfico: las peticiones correctas y fallidas a lo largo del tiempo, para que veas cuándo empezaron los errores.
• Búsqueda: busca en la ruta, el mensaje, el método o el estado.
• Filtros: Source (API o SMTP), Outcome (Success o Error), Method, Path, Message, Status code, Duration, Created y API key.

La tabla muestra Timestamp, Level (Success para los códigos de estado inferiores a 400 y Error en el resto), Source, Method, Message (por ejemplo POST /v2/emails → 422), Status y Duration.

Leer una petición

Selecciona una fila para abrirla. La página muestra:

• Created, Level, Source y Status.
• Request body: el JSON que envió tu código o, en SMTP, el comando, el sobre y el resumen del mensaje.
• Response body: lo que devolvió Emailit, incluidos los detalles del error.
• Details: el ID del registro, la ruta, la duración, el ID de la clave de API (credential_id), la dirección IP, el agente de usuario y el ID de la petición.

Depurar los errores 4xx

1. Filtra los errores. Pon Outcome en Error, o Status code en el código que recibiste, y elige un intervalo que cubra el fallo.

2. Abre la petición y lee el cuerpo de la respuesta. Los cuerpos de error de Emailit indican qué ha fallado. Los errores de validación enumeran cada problema en validation_errors o en details.

3. Compáralo con el cuerpo de la petición. Comprueba los campos que recibió Emailit. Las sorpresas habituales son un dominio from que falta, un to enviado como objeto o un scheduled_at en un formato inesperado.

4. Elige la solución según el código de estado.

   Estado	Causa habitual	Dónde leer más
   400	JSON mal formado o un error de validación.	Errores
   401	Falta la clave de API o no es válida. Las claves desconocidas no se registran.	Autenticación
   402	No hay créditos suficientes para el envío.	Créditos
   403	El espacio de trabajo no está verificado y un destinatario no es miembro (unverified_workspace_recipient), la clave está limitada a otro dominio, la función necesita un plan superior (plan_required) o el espacio de trabajo está suspendido.	Acceso de producción
   409	Un duplicado, o una petición con la misma Idempotency-Key que todavía está en curso.	Idempotencia
   413	El mensaje ocupa más de 40 MB.	Adjuntos
   422	La petición es válida pero no se puede ejecutar, por ejemplo reintentar un email que no admite reintentos.	Errores
   429	Se ha alcanzado el límite de envío por segundo o el diario. El cuerpo incluye limit, current y retry_after.	Límites de velocidad

   En SMTP, los mismos problemas aparecen como códigos de respuesta SMTP, por ejemplo 530 cuando el dominio From no está verificado o 452 por los límites de velocidad. Consulta Solución de problemas de SMTP.

5. Corrige y vuelve a enviar. Una petición que falló con un 4xx no creó ningún email, así que puedes volver a enviarla sin riesgo una vez corregida.

Si aquí la petición se completó pero el email no llegó, el problema ocurrió más tarde. Busca el email en Email API›Emails y lee sus intentos de entrega.

Retención

Los registros de peticiones siguen el periodo de retención de Logs:

	Pay as you go	Pro	Business	Custom
Retención de los registros de peticiones	7 días	30 días	30 días	Flexible

Los registros de peticiones solo están disponibles en el panel; no hay ningún endpoint de la API para ellos.

Ver también