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

# Códigos de error

> Códigos de estado HTTP comunes de la API de Trophy.

Esta página resume los códigos de estado HTTP que verá con mayor frecuencia al integrar con la API de la aplicación Trophy. Para el comportamiento específico de cada endpoint y los esquemas de respuesta, consulte la [referencia de la API](/es/api-reference/introduction).

<h2 id="authentication-errors">
  Errores de autenticación
</h2>

| Estado             | Cuándo ocurre                                  | Qué hacer                                                                                                                    |
| ------------------ | ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `401 Unauthorized` | Falta el encabezado `X-API-KEY` o no es válido | Cree o rote una clave de API de aplicación y verifique la configuración de [autenticación](/es/api-reference/authentication) |

<h2 id="rate-limiting">
  Límite de solicitudes
</h2>

| Estado                  | Cuándo ocurre                                                                                    | Qué hacer                                                                      |
| ----------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
| `429 Too Many Requests` | Su organización excedió los [Límites de velocidad](/es/api-reference/rate-limiting) del endpoint | Reduzca la frecuencia y reintente; solicite un límite más alto si es necesario |

<h2 id="retry-guidance">
  Orientación para reintentos
</h2>

* Reintente `429` y `5xx` con backoff exponencial.
* Al reintentar, envíe la misma clave de idempotencia para la misma acción lógica para que Trophy no cuente dos veces.
* No reintente `401` hasta que se corrija la clave de API.

<h2 id="get-support">
  Obtener soporte
</h2>

¿Quiere ponerse en contacto con el equipo de Trophy? Comuníquese con nosotros por [correo electrónico](mailto:support@trophy.so). ¡Estamos aquí para ayudar!


## Related topics

- [Reintentos](/es/webhooks/retries.md)
- [Autenticación](/es/api-reference/authentication.md)
- [Eventos](/es/features/events.md)
- [Bibliotecas de Cliente](/es/admin-api/client-libraries.md)
- [Idempotencia](/es/webhooks/idempotency.md)