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

# Códigos de estado HTTP

> Códigos HTTP devueltos con una respuesta.

Los errores se devolverán con [códigos de estado HTTP estándar](https://tools.ietf.org/html/rfc2616#section-10).

Los códigos de estado son los siguientes:

<ul class="custom-bullets">
  <li>1xx: Informativo - Comunica información a nivel del protocolo de transferencia.</li>
  <li>2xx: Éxito - La solicitud se realizó con éxito.</li>
  <li>3xx: Redirección - El cliente debe realizar alguna acción adicional para completar la solicitud.</li>
  <li>4xx: Error del cliente - Solicitud fallida debido a un error del cliente.</li>
  <li>5xx: Error del servidor - Solicitud fallida debido a un error del servidor.</li>
</ul>

### 200 Success

Se realizó una solicitud exitosa.

### 400 Bad Request

Un error `400 Bad Request` significa que el servidor no pudo procesar la solicitud. La causa más común es una sintaxis incorrecta en la URL de la solicitud o en el body.

### 401 Unauthorized

Los errores `401 Unauthorized` suelen deberse a un problema en el header de la solicitud de tu llamada a la API, es decir, no usaste un API Key válido para realizar la llamada.

### 403 Access Denied

Cuando tu aplicación hace una llamada a la API con tu API Key y la solicitud no está permitida.
También se puede devolver un 403 si el [User Profile está suspendido](/multiple-users/manage-user-profiles#reactivate-a-suspended-user-profile).

### 404 Resource Not Found

Este error ocurre cuando tu aplicación intenta llamar a una API o consultar una entidad que no existe.

### 405 Method Not Allowed

Este error indica que los métodos del protocolo HTTP en tu solicitud no son compatibles. Consulta la documentación de la API para ver los métodos admitidos.

### 429 Rate Limit

#### Rate limits de User Profile

Cada User Profile tiene un rate limit de 300 solicitudes a la API cada 5 minutos. Puedes monitorear tu uso del rate limit mediante los headers de respuesta:

<ul class="custom-bullets">
  <li>`x-ratelimit-max`: muestra el máximo de solicitudes permitidas por período de 5 minutos</li>

  <li>
    `x-ratelimit-count`: muestra cuántas solicitudes has realizado en el período actual de 5 minutos
  </li>
</ul>

<Info>
  Te recomendamos revisar las respuestas con código de error 429. Si ves un error 429, has alcanzado tu rate
  limit. Los intentos repetidos de superar el rate limit pueden resultar en la suspensión del User Profile.

  Aprende más sobre [cómo manejar rate limits](https://www.ayrshare.com/blog/complete-guide-to-handling-rate-limits-prevent-429-errors/) para varios User Profiles.
</Info>

#### Rate limits de analíticas por plataforma

También se puede devolver un HTTP `429` cuando una red social limita las llamadas de analíticas para una cuenta específica, independientemente de los límites de tu User Profile de Ayrshare. En ese caso, la respuesta contiene un código de error de Ayrshare específico de la plataforma (por ejemplo, [`code: 444`](/errors/errors-ayrshare#facebook-analytics-rate-limit) para los throttles de analíticas por Página de Facebook). Inspecciona el campo `code` para distinguir un rate limit de User Profile de un throttle del lado de la plataforma, y reintenta con backoff en lugar de pedirle al usuario que vuelva a vincular.

#### Rate limits de eliminación de User Profiles

Puedes eliminar 8 User Profiles por segundo. Escalona las llamadas a la API si necesitas eliminar en bloque.

#### Protección de rate limit y política de suspensión

Para proteger la integridad de nuestro sistema, aplicamos suspensión automática si un User Profile supera los rate limits con demasiada frecuencia.
Así funciona:

Cuando haces solicitudes a la API, debes gestionar cuidadosamente la ventana de 5 minutos.
Por ejemplo, si haces 300 solicitudes en un minuto, tendrás que esperar cuatro minutos más antes de hacer solicitudes adicionales.
Cualquier solicitud durante este período de espera activará una respuesta de error `429`.

Si un User Profile acumula 1000 violaciones de rate limit (errores 429) dentro de un período de 24 horas, el perfil se suspenderá automáticamente.
Una vez transcurrido el período de espera de 5 minutos, puedes reanudar las solicitudes hasta el límite estándar de 300 por ventana de 5 minutos.

### 500 Internal Server Error

Un `500 Internal Server Error` indica que Ayrshare está experimentando un error interno o que el procesamiento falló.
