> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Logs de Desarrollador

> Accede e interpreta los logs de API en la plataforma de administración de Topsort

## Dónde Encontrar los Logs

Navega a la pestaña **Herramientas de Desarrollo** en tu Plataforma de Anuncios de Topsort para acceder a los logs en tiempo real de tu clave API.

## Disponibilidad de Logs

| Entorno        | Qué se Registra                              | Retención |
| -------------- | -------------------------------------------- | --------- |
| **Staging**    | Todas las solicitudes y respuestas de la API | 30 días   |
| **Producción** | Solo errores y solicitudes fallidas          | 30 días   |

<Note>
  A medida que aumenta el uso de tu API en producción, las solicitudes exitosas pueden filtrarse de los logs para mejorar el rendimiento. Los errores y la información de depuración siempre estarán disponibles.
</Note>

## Comprender las Entradas de Log

### Solicitudes Exitosas

<img src="https://mintcdn.com/topsort/oVmv62U7qVFoTD_d/en/api-reference/5a7e3e4-87895af-Schema-validator-notification.webp?fit=max&auto=format&n=oVmv62U7qVFoTD_d&q=85&s=430bfba5e57697b63ab0eaa29747322a" alt="Captura de pantalla de notificación del validador de esquema" width="1278" height="951" data-path="en/api-reference/5a7e3e4-87895af-Schema-validator-notification.webp" />

Las llamadas exitosas a la API muestran:

* **Estado:** Códigos de estado HTTP 200/201/204
* **Marca de tiempo:** Cuándo se realizó la solicitud
* **Endpoint:** Qué endpoint de la API fue llamado
* **Tiempo de respuesta:** Cuánto tiempo tomó la solicitud
* **Tamaño de solicitud:** Tamaño de los datos de solicitud/respuesta

### Entradas de Error

<img src="https://mintcdn.com/topsort/1RZV69Uhic79Ylqv/en/api-reference/bcb6eb0-b5dedc7-Schema-validator-error.webp?fit=max&auto=format&n=1RZV69Uhic79Ylqv&q=85&s=1562f907c238249ec7141353afe2ab00" alt="Captura de pantalla de error del validador de esquema" width="1297" height="463" data-path="en/api-reference/bcb6eb0-b5dedc7-Schema-validator-error.webp" />

Las solicitudes fallidas incluyen información adicional de depuración:

* **Estado:** Código de error HTTP (400, 401, 403, etc.)
* **Detalles del error:** Código de error específico y mensaje
* **Cuerpo de la solicitud:** Qué datos fueron enviados (para depuración)
* **Stack trace:** Detalles internos del error (cuando estén disponibles)

## Patrones Comunes de Log

### Problemas de Autenticación

```
401 Unauthorized - invalid_api_key
Missing Authorization header
```

**Solución:** Agrega el encabezado `Authorization: Bearer TU_CLAVE_API`

### Errores de Validación

```
422 Unprocessable Entity - invalid_product_id
Product 'sku_123' not found in catalog
```

**Solución:** Verifica que el producto exista y esté escrito correctamente

### Limitación de Tasa

```
429 Too Many Requests - rate_limited
X-RateLimit-Remaining: 0
```

**Solución:** Implementa lógica de reintento con retroceso exponencial

## Usar Logs para Depuración

### 1. Eventos que No Aparecen en el Panel

Busca:

* **Estado 200** en llamadas a `/events`
* **Errores de validación** en el payload del evento
* **Problemas de marca de tiempo** (`occurredAt` en el futuro o demasiado antiguo)

### 2. Resultados de Subasta Vacíos

Verifica:

* Estado del presupuesto de la campaña
* Disponibilidad del producto en el catálogo
* Formato de la solicitud de subasta

### 3. Problemas de Atribución

Revisa los logs de eventos para:

* Uso consistente del ID de usuario
* `resolvedBidId` apropiado de las subastas
* Tiempo de los eventos de clic/compra

## Mejores Prácticas

### Monitoreo de Logs

* Revisa los logs después de implementar nuevo código de integración
* Monitorea las tasas de error durante períodos de alto tráfico
* Configura alertas para patrones de error recurrentes

### Flujo de Trabajo de Resolución de Problemas

1. **Reproduce el problema** en el entorno de staging
2. **Revisa los logs recientes** en busca de patrones de error
3. **Verifica el formato de la solicitud** contra la [documentación de la API](/es/api-reference)
4. **Prueba con un payload mínimo** para aislar el problema
5. **Contacta al soporte** con marcas de tiempo de log para problemas complejos

## Privacidad y Manejo de Datos

* Los logs pueden contener datos sensibles de tus solicitudes
* Los logs de producción expiran automáticamente después de 30 días
* El acceso a los logs está restringido solo a usuarios administradores
* Los datos personales en los logs siguen políticas estándar de retención de datos

## ¿Necesitas Ayuda?

Si estás viendo errores persistentes en tus logs:

1. **Anota la marca de tiempo** de las solicitudes problemáticas
2. **Copia el mensaje de error exacto** y los detalles de la solicitud
3. **Contacta al soporte** con esta información para una resolución más rápida

Nuestro equipo puede acceder a logs detallados del lado del servidor para ayudar a diagnosticar problemas complejos de integración.