# Registros de peticiones

> Inspecciona todas las peticiones a la API v2 y todas las transacciones SMTP hechas con tus claves de API, incluidos los cuerpos de la petición y de la respuesta, para depurar los errores 4xx.

**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.»

| Origen | Qué se registra |
| --- | --- |
| **API** | Cada petición a `https://api.emailit.com/v2/…` que Emailit puede vincular a tu espacio de trabajo: método, ruta, código de estado, duración, clave de API, dirección IP, agente de usuario y los cuerpos de la petición y de la respuesta. |
| **SMTP** | Cada comando `DATA`, con el resultado (`250 2.0.0 OK: queued as em_…` o el error), el remitente del sobre, los destinatarios, las cabeceras y el tamaño del mensaje. También los rechazos de `MAIL FROM` causados por los límites de velocidad (`452`) y los intentos de `AUTH` fallidos con una clave de API revocada (`535`). |

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](/es/docs/api-reference/errors/) |
   | `401` | Falta la clave de API o no es válida. Las claves desconocidas no se registran. | [Autenticación](/es/docs/api-reference/authentication/) |
   | `402` | No hay créditos suficientes para el envío. | [Créditos](/es/docs/billing/credits/) |
   | `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](/es/docs/workspaces/production-access/) |
   | `409` | Un duplicado, o una petición con la misma `Idempotency-Key` que todavía está en curso. | [Idempotencia](/es/docs/api-reference/idempotency/) |
   | `413` | El mensaje ocupa más de 40 MB. | [Adjuntos](/es/docs/email-api/attachments/) |
   | `422` | La petición es válida pero no se puede ejecutar, por ejemplo reintentar un email que no admite reintentos. | [Errores](/es/docs/api-reference/errors/) |
   | `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](/es/docs/api-reference/rate-limits/) |

   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](/es/docs/smtp/troubleshooting/).

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](/es/docs/logs/email-details/#deliveries-loads-and-clicks).

## 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

  - [Errores de la API](/es/docs/api-reference/errors/)
  - [Solución de problemas de SMTP](/es/docs/smtp/troubleshooting/)

---
Fuente: https://emailit.com/es/docs/logs/request-logs/
