> ## 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 Streaming Hub

> Busca los códigos de error de Streaming Hub, el estado HTTP que lleva cada uno y qué corregir en la solicitud que lo provocó.

**Formato del error**

Streaming Hub devuelve la mayoría de los errores como detalles de problema RFC 9457 con el tipo de medio `application/problem+json`. Solo una respuesta con ese tipo de medio lleva el envelope siguiente:

<CodeGroup>
  ```json JSON theme={null}
  {
    "type": "https://errors.lerian.studio/v1/not_found",
    "title": "Not Found",
    "status": 404,
    "detail": "subscription not found",
    "code": "not_found"
  }
  ```
</CodeGroup>

**Definiciones de los campos**

* **`type`** – Un URI estable y con versión que identifica el tipo de problema. Streaming Hub lo construye como `https://errors.lerian.studio/v1/<code>` y lo omite para un problema al que no asigna código.
* **`title`** – Un resumen breve y legible para personas, que es el texto del estado HTTP (por ejemplo, `Not Found`).
* **`status`** – El código de estado HTTP, reflejado en el cuerpo.
* **`detail`** – Una explicación segura para quien llama, sobre esta ocurrencia. En una respuesta `5xx`, Streaming Hub reemplaza el detalle por la cadena fija `internal error`, de modo que no se filtra ninguna causa interna.
* **`code`** – El token estable, de baja cardinalidad y legible por máquina sobre el que ramificar la lógica. Una falla de validación de la solicitud, y una solicitud que no coincide con ninguna ruta, llegan con este campo vacío. En ese caso, ramifica sobre `status`. En ese caso, ramifica sobre `status`.

## Errores del cliente

***

| `code` | Descripción | Estado |
| - | - | - |
| `bad_request` | La solicitud está mal formada, o falta una entrada obligatoria. | 400 |
| `missing_idempotency_key` | La solicitud omite el header `X-Idempotency` obligatorio. Streaming Hub rechaza la solicitud antes de cualquier escritura. | 400 |
| `invalid_error_class` | El filtro `error_class` en el listado de dead-letter tiene un valor fuera de las clases de transporte reconocidas. Proporciona una clase reconocida. | 400 |
| `invalid_cursor` | El cursor `after` en el listado de dead-letter no es un identificador de fila bien formado. Reinicia el listado. | 400 |
| `unauthorized` | La autenticación falló, o la solicitud no lleva un contexto de tenant confiable. El cuerpo es el mismo para cada causa que el hub responde por sí mismo. | 401 |
| `forbidden` | La credencial es válida, pero el ámbito delegado que presenta la solicitud no coincide con el claim de ámbito del token retransmitido. | 403 |
| `not_found` | El recurso está ausente, eliminado de forma lógica, en poder de otro tenant, o es de otro tipo. El token es el mismo para cada uno de estos casos. | 404 |
| `idempotency_conflict` | Hay una solicitud duplicada en curso, o la misma clave `X-Idempotency` llegó con una huella de solicitud diferente. | 409 |
| `validation_error` | La solicitud lleva una falla de forma corregible por quien llama: un `sink_kind` incorrecto, o un endpoint, schema o valor de `event_types` inválido. | 422 |
| `inline_sink_config_forbidden` | Una solicitud de creación llevaba material `sink_config` o `credential` en línea. Envía una credencial de cola a través de `PUT /v1/subscriptions/{id}/credential` en su lugar. | 422 |
| `endpoint_blocked` | El host resuelto está bloqueado, es privado o es una dirección de metadatos, o la URL lleva información de usuario incorporada. Proporciona un endpoint público que no contenga ninguna credencial. | 422 |
| `no_secret_to_rotate` | Una rotación de secreto tuvo como destino una suscripción que no tiene ningún secreto de firma. | 422 |
| `probe_unsupported_for_sink_kind` | El tipo de sink no tiene ninguna prueba registrada para esta operación. Los tipos de sink de este grupo verifican a través de sus propias superficies. | 422 |
| `rate_limited` | El límite de lectura entrante por tenant denegó la solicitud. Espera y vuelve a intentarlo. | 429 |

<Note>
  La capa de autenticación y autorización se ejecuta antes que Streaming Hub. Un `401` o un `403` que rechaza esta capa devuelve un cuerpo de texto plano, no un documento de problema. Ese cuerpo no lleva ningún `code`.
</Note>

## Errores del servidor

***

| `code` | Descripción | Estado |
| - | - | - |
| `internal_error` | Una falla de infraestructura. Streaming Hub reemplaza `detail` por `internal error` y registra la causa. | 500 |