Registros
El registro de cada solicitud hecha con una clave de API y de cada envío por SMTP.
Para qué sirve
Los Registros guardan cada solicitud hecha a la API con una clave y cada correo electrónico enviado por SMTP, con el cuerpo que enviaste y la respuesta que devolvió Postal. Es el primer lugar donde mirar cuando una integración "no funciona".
Cuándo usarlo: Para depurar un error (400, 401, 422, 429), comprobar lo que tu sistema envió realmente y ver qué clave hizo la llamada.
#Lista de registros
Dónde está: Desarrolladores › Registros. Dirección: app.postal.so/logs.
Aparecen las llamadas hechas con claves de API y los envíos por SMTP; lo que haces dentro del panel no entra aquí. Los registros se guardan durante 30 días.
| Elemento | Qué hace |
|---|---|
| Buscar por endpoint | Filtra por la ruta de la llamada (por ejemplo, /emails). |
| Período | Accesos directos (Hoy, Ayer, Últimas 24 horas, Últimos 3 días, Últimos 7 días, Últimos 15 días y Últimos 30 días), calendario y Todo el periodo. |
| Filtros › Estado | Éxito (2xx), Error del cliente (4xx), Error del servidor (5xx) o Límite de solicitudes (429). |
| Filtros › Origen | API o SMTP (API y SMTP muestra ambos). |
| Filtros › User agent | El programa que hizo la llamada: SDK de Node.js, SDK de PHP, SDK de Python o cURL (Todos los clientes lo borra). |
| Filtros › Clave de API | Solo las llamadas de una clave. |
| Exportar | Genera un CSV de los registros con los filtros actuales. |
| Columna | Qué muestra |
|---|---|
| Endpoint | El método y la ruta, como POST /emails. Al hacer clic se abre el detalle. |
| Estado | El código HTTP de la respuesta, en verde (2xx), amarillo (4xx) o rojo (5xx). |
| Clave | El nombre de la clave de API usada, o clave eliminada si fue revocada. |
| User agent | El programa cliente, o Cliente SMTP en los envíos por SMTP. |
| Fecha | Fecha y hora de la solicitud. |
Consejo
Los errores 4xx casi siempre vienen de la llamada (campo que falta, clave sin permiso, dominio no verificado). Filtra por Error del cliente (4xx) y abre un registro: la respuesta incluye el name del error, que se explica en Errores. Muchos Límite de solicitudes (429) indican que conviene usar el envío por lotes o revisar los límites.
#Detalle de un registro
Dónde está: Desarrolladores › Registros, haciendo clic en una fila. Dirección: app.postal.so/logs.
El encabezado muestra el método y la ruta, la fecha y el user agent, y el código de estado. Debajo, dos bloques lado a lado:
| Bloque | Qué muestra |
|---|---|
| Solicitud | El cuerpo JSON que envió tu sistema. Si está vacío, aparece Sin cuerpo. |
| Respuesta | El JSON que devolvió Postal: el id del correo creado, o el error con statusCode, name y message. |
El contenido de los adjuntos no se guarda en el registro: en su lugar aparece el tamaño, como [1234 bytes em base64], y los textos muy largos se recortan. En las llamadas GET, la Solicitud muestra los parámetros de la URL. Para ver qué pasó con el correo después de crearlo, abre el correo en Correos: el campo Solicitud conecta ambos.
Mira también: Registros (API) · Errores · Claves de API.