# 🚨 Límites de tasa y errores

## 🚨 Límites de tasa y errores

Respeta los límites operativos de la API.

Los clientes agresivos degradan el servicio para todos.

{% hint style="warning" %}
Los clientes que no respeten los límites de peticiones están sujetos a bloqueos temporales o permanentes.
{% endhint %}

### Códigos de estado comunes

| Código | Nombre                       | Significado                                                                       |
| ------ | ---------------------------- | --------------------------------------------------------------------------------- |
| `200`  | `OK`                         | La operación se completó correctamente.                                           |
| `400`  | `Petición Incorrecta`        | El payload es inválido o la operación no puede ejecutarse con los datos enviados. |
| `401`  | `No Autorizado`              | Falta `x-api-key` o la clave no es válida.                                        |
| `403`  | `Prohibido`                  | La clave es válida, pero no tiene permisos para esa operación.                    |
| `404`  | `No Encontrado`              | El recurso solicitado no existe o no puede resolverse.                            |
| `500`  | `Error Interno del Servidor` | Ocurrió un fallo inesperado en el backend.                                        |

### Formato estándar de error

Cuando una petición falla, la API responde con un objeto JSON simple:

```json
{
  "error": "Mensaje descriptivo del problema"
}
```

### Qué esperar del mensaje

El campo `error` describe la causa inmediata del fallo.

Úsalo para depurar, registrar eventos y mostrar mensajes claros en tus herramientas internas.

### Buenas prácticas

* Valida tu payload antes de enviar la petición.
* Maneja `401` y `403` como errores de seguridad.
* Trata `500` como un fallo recuperable con reintentos controlados.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://scarlet-2.gitbook.io/docs.mxrp/para-desarrolladores/limites-de-tasa-y-errores.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.