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

# Códigos de Error

> Cuando la API de ER:LC Rusia rechaza una solicitud, devuelve una respuesta JSON con un código de error. Esta página te ayuda a comprender rápidamente qué ocurrió y cómo puede solucionarlo tu servicio.

### Formato de Respuesta de Error

Todos los errores se devuelven en formato JSON con los campos `code` y `message`.

**Por ejemplo:**

```json theme={null}
{
  "code": 5007,
  "message": "Missing Token"
}
```

## Tabla de Errores de la API de ER:LC Rusia

<AccordionGroup>
  <Accordion title="Errores Internos de la API (5001–5037)">
    | Código | Descripción                  | Significado                                                                             |
    | ------ | ---------------------------- | --------------------------------------------------------------------------------------- |
    | `5001` | Missing Discord Id           | Falta `discord_id`. Agrega el campo `discord_id` al cuerpo de la solicitud              |
    | `5002` | Missing Parameters           | Faltan parámetros obligatorios. Revisa el cuerpo de la solicitud                        |
    | `5003` | Invalid Version              | Versión de API no válida. Usa `v1` o `v2`                                               |
    | `5004` | Invalid Param Name           | Nombre de parámetro de consulta no válido                                               |
    | `5005` | Missing Command              | Comando no proporcionado. Agrega el campo `command` al cuerpo de la solicitud           |
    | `5006` | Invalid Master Key           | Clave maestra no válida. Contacta a un administrador                                    |
    | `5007` | Missing Token                | Falta el token. Agrega el encabezado `Authorization: Bearer <token>`                    |
    | `5008` | Invalid Token                | El token no es válido o ha sido desactivado                                             |
    | `5009` | Forbidden                    | Sin acceso a este endpoint. Contacta a un administrador                                 |
    | `5010` | Api Version Forbidden        | El acceso a esta versión de la API está prohibido para tu clave                         |
    | `5011` | Query Param Forbidden        | El acceso a los parámetros de consulta solicitados está prohibido                       |
    | `5012` | Discord Id Not Found         | ID de Discord no encontrado en la base de datos                                         |
    | `5013` | Token Not Found              | Token no encontrado                                                                     |
    | `5014` | Token Not Found Or Deleted   | Token no encontrado o ha sido eliminado                                                 |
    | `5015` | Command Queue Full           | La cola de comandos está llena. Inténtalo de nuevo más tarde                            |
    | `5016` | Rate Limit Exceeded          | Límite de solicitudes superado. Espera el reinicio (consulta `retry_after`)             |
    | `5017` | Internal Error               | Error interno del servidor. El error ha sido registrado                                 |
    | `5018` | Server Error                 | Error al acceder a la API externa. Los datos pueden provenir de la caché                |
    | `5019` | Prc Api Error                | Error de la API de PRC. Consulta el campo `prc_code` para el código de error de PRC     |
    | `5020` | Not Found                    | Endpoint no encontrado. Revisa la URL de la solicitud                                   |
    | `5021` | Webhook Url Already Exists   | La URL del webhook ya existe                                                            |
    | `5022` | Webhook Not Found            | Webhook no encontrado                                                                   |
    | `5023` | Webhook Url Not Found        | URL del webhook no encontrada                                                           |
    | `5024` | Cache Expired                | La caché está obsoleta y no disponible. Todas las fuentes de datos devolvieron un error |
    | `5025` | Websocket Key Not Found      | Clave de WebSocket no encontrada                                                        |
    | `5026` | Invalid Subscription Channel | Canal de suscripción no válido                                                          |
    | `5034` | Invalid Json                 | Formato JSON no válido en el cuerpo de la solicitud                                     |
    | `5035` | Missing Signature Headers    | Faltan encabezados de firma (`X-Signature-Ed25519`, `X-Signature-Timestamp`)            |
    | `5036` | Timestamp Too Old            | La marca de tiempo de la solicitud es demasiado antigua (más de 5 minutos)              |
    | `5037` | Invalid Signature            | Firma de solicitud no válida                                                            |
  </Accordion>

  <Accordion title="Errores del WebSocket Gateway (5101–5134)">
    | Código | Descripción            | Significado                                              |
    | ------ | ---------------------- | -------------------------------------------------------- |
    | `5101` | Invalid Message Format | Revisa el formato JSON y el campo `action`               |
    | `5102` | Token Required         | Agrega el campo `token` al mensaje `auth`                |
    | `5107` | Not Authenticated      | Envía un mensaje `auth` antes de otras acciones          |
    | `5108` | Invalid Token          | Revisa tu token de WebSocket                             |
    | `5109` | Connection Blocked     | Contacta a un administrador                              |
    | `5117` | Authentication Failed  | Error interno. Inténtalo de nuevo más tarde              |
    | `5127` | Connected              | Código informativo, no requiere acción                   |
    | `5128` | Auth Success           | Código informativo, no requiere acción                   |
    | `5129` | Pong                   | Código informativo, no requiere acción                   |
    | `5130` | Subscription Denied    | Sin acceso a este canal de datos                         |
    | `5131` | Subscribed             | Código informativo, no requiere acción                   |
    | `5132` | Unsubscribed           | Código informativo, no requiere acción                   |
    | `5133` | Cache Empty            | Datos aún no cargados, por favor espera                  |
    | `5134` | Empty Snapshot         | La caché existe pero no hay datos para tus suscripciones |
  </Accordion>

  <Accordion title="Errores de la API de Economía (6000–6021)">
    | Código | Descripción                                      | Significado                                                    |
    | ------ | ------------------------------------------------ | -------------------------------------------------------------- |
    | `6000` | Unknown Error Occurred                           | Revisa los registros, contacta a un administrador              |
    | `6001` | Database Error Occurred. Please Try Again Later. | Reintenta la solicitud después de unos segundos                |
    | `6002` | Invalid Amount Specified.                        | Revisa el formato de la cantidad (debe ser un número positivo) |
    | `6003` | Invalid Or Missing Parameters.                   | Revisa los campos obligatorios en la solicitud                 |
    | `6004` | Requested Resource Not Found.                    | Revisa el ID del recurso                                       |
    | `6005` | Internal Server Error Occurred.                  | Reintenta la solicitud más tarde                               |
    | `6006` | Discord Operation Failed.                        | Revisa los permisos del bot en Discord                         |
    | `6007` | Data Serialization Error.                        | Contacta a un administrador                                    |
    | `6008` | Guild Not Found                                  | Revisa el `guildId` en los parámetros                          |
    | `6009` | Discord Channel Not Found                        | Revisa el `channelId` en la solicitud                          |
    | `6010` | Business Not Found                               | Revisa el `businessId` o `businessName`                        |
    | `6011` | Mafia Not Found                                  | Revisa el `mafiaId` o `mafiaName`                              |
    | `6012` | Transaction Not Found                            | Revisa el `transactionId`                                      |
    | `6013` | Item Not Found                                   | Revisa el `itemName`                                           |
    | `6014` | Request Not Found Or Expired                     | Revisa el `requestId`                                          |
    | `6015` | Duplicate Entry Found.                           | El recurso ya existe                                           |
    | `6016` | User Not Found                                   | Revisa el `userId`                                             |
    | `6017` | Insufficient Funds                               | El usuario no tiene fondos suficientes                         |
    | `6018` | Invalid Action Specified                         | Revisa el parámetro `action`                                   |
    | `6019` | Missing Required Fields                          | Completa todos los campos obligatorios                         |
    | `6020` | Permission Denied                                | Revisa el token y los permisos de acceso                       |
    | `6021` | Rate Limit Exceeded                              | Espera a que se reinicie el límite                             |
  </Accordion>
</AccordionGroup>

## Tabla de Errores de la API de ER:LC

Estos códigos de error pueden ser devueltos por la API externa de ER:LC al realizar solicitudes a los endpoints `*/erlc/*`.

<AccordionGroup>
  <Accordion title="Errores del Sistema (0, 1001, 1002)">
    | Código | Significado                                                                                                                                                                            |
    | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | `0`    | Ocurrió un error desconocido. Si el error persiste, contacta al soporte de ER:LC Rusia mediante un ticket (nos comunicaremos con el soporte de PRC si el error ocurre con frecuencia). |
    | `1001` | Error de comunicación con Roblox o con el servidor privado dentro del juego.                                                                                                           |
    | `1002` | Ocurrió un error interno del sistema.                                                                                                                                                  |
  </Accordion>

  <Accordion title="Errores de Autenticación (2000–2004)">
    | Código | Significado                                                   |
    | ------ | ------------------------------------------------------------- |
    | `2000` | No proporcionaste una clave de servidor (server-key).         |
    | `2001` | Proporcionaste una clave de servidor en un formato no válido. |
    | `2002` | Proporcionaste una clave de servidor no válida o vencida.     |
    | `2003` | Proporcionaste una clave de API global no válida.             |
    | `2004` | Tu clave de servidor tiene el acceso a la API bloqueado.      |
  </Accordion>

  <Accordion title="Errores de Solicitud (3001–3002)">
    | Código | Significado                                                                        |
    | ------ | ---------------------------------------------------------------------------------- |
    | `3001` | No especificaste un comando válido en el cuerpo de la solicitud.                   |
    | `3002` | El servidor al que intentas acceder está desconectado actualmente (sin jugadores). |
  </Accordion>

  <Accordion title="Errores de Límite de Frecuencia y Acceso (4001–4003)">
    | Código | Significado                                        |
    | ------ | -------------------------------------------------- |
    | `4001` | Límite de frecuencia de solicitudes superado.      |
    | `4002` | El comando que intentas ejecutar está restringido. |
    | `4003` | El mensaje que intentas enviar está prohibido.     |
  </Accordion>

  <Accordion title="Códigos Especiales (9998, 9999)">
    | Código | Significado                                             |
    | ------ | ------------------------------------------------------- |
    | `9998` | El recurso al que intentas acceder está restringido.    |
    | `9999` | El módulo en el servidor del juego está desactualizado. |
  </Accordion>
</AccordionGroup>

## Manejo del Código `0`

Si encuentras un error con el código `0` (Error Desconocido) y persiste a lo largo de varias solicitudes consecutivas, crea un ticket en nuestro servidor de Discord. Adjunta los detalles de tu solicitud al ticket para que nuestro equipo pueda investigar el problema.
