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

# Lista de errores de Systemplane

> Busca los tokens de error que devuelve la API de administración de Systemplane, el estado HTTP que lleva cada uno y qué hacer al respecto.

**Formato del error**

La API de administración de Systemplane devuelve los errores como un objeto JSON plano con el tipo de medio `application/json`:

<CodeGroup>
  ```json JSON theme={null}
  {
    "code": 404,
    "title": "not_found",
    "message": "key not found"
  }
  ```
</CodeGroup>

Lee estos campos con cuidado. El campo `code` lleva el estado HTTP como número, no como token de texto. El token legible por máquina está en `title`. Ramifica sobre `title`, no sobre `code`.

**Definiciones de los campos**

* **`code`** – El código de estado HTTP, como entero. Repite el estado de la respuesta.
* **`title`** – Un token corto y legible por máquina para la clase de error. Usa este valor para el manejo programático.
* **`message`** – Una descripción legible para personas de lo que salió mal.

## Errores del cliente

***

| `title`                     | Descripción                                                                                      | Estado |
| --------------------------- | ------------------------------------------------------------------------------------------------ | ------ |
| `bad_request`               | El cuerpo de la solicitud está ausente, es ilegible, o no lleva ningún campo `value` utilizable. | 400    |
| `unknown_key`               | La clave no está registrada en el catálogo.                                                      | 400    |
| `validation_error`          | El valor falla el validador de la clave, o el namespace o la clave superan la longitud máxima.   | 400    |
| `not_supported`             | La operación no está disponible en modo multi-tenant.                                            | 400    |
| `tenant_connection_missing` | La base de datos del tenant está ausente en el contexto de la solicitud.                         | 400    |
| `nil_context`               | El contexto de la solicitud no está disponible.                                                  | 400    |
| `forbidden`                 | El autorizador rechazó la acción para esta identidad y este namespace.                           | 403    |
| `not_found`                 | La clave o entrada de catálogo solicitada no existe.                                             | 404    |

<Note>
  La autenticación se ejecuta en la aplicación que aloja la superficie de administración, antes de las rutas de configuración. Una solicitud que falla la autenticación recibe un 401 de esa aplicación anfitriona, en su propio formato de error. Consulta la referencia de API de la aplicación cuya configuración administras.
</Note>

## Errores del servidor

***

| `title`               | Descripción                                                                                                                               | Estado |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| `internal_error`      | La solicitud falló dentro del servicio. El mensaje se mantiene genérico. Vuelve a intentarlo y, si la falla continúa, contacta a soporte. | 500    |
| `service_unavailable` | El almacén de configuración no se inició, o se detuvo. Vuelve a intentarlo tras un breve intervalo.                                       | 503    |