> ## Documentation Index
> Fetch the complete documentation index at: https://omer-914cc1c6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuración de AsyncAPI

> Crea páginas de referencia de WebSocket con AsyncAPI

<div id="add-an-asyncapi-specification-file">
  ## Añade un archivo de especificación de AsyncAPI
</div>

Para empezar a crear páginas para tus websockets, asegúrate de contar con un documento de esquema de AsyncAPI válido en formato JSON o YAML que cumpla con la [especificación de AsyncAPI](https://www.asyncapi.com/docs/reference/specification/v3.0.0). Tu esquema debe ajustarse a la especificación de AsyncAPI 3.0 o superior.

<Tip>
  Para verificar que tu esquema de AsyncAPI sea válido, puedes pegarlo en
  [AsyncAPI Studio](https://studio.asyncapi.com/)
</Tip>

<div id="auto-populate-websockets-pages">
  ## Autogenerar páginas de websockets
</div>

Puedes agregar un campo `asyncapi` a cualquier tab o grupo en la navigation de tu `docs.json`. Este campo puede contener la ruta a un documento de esquema de AsyncAPI en tu repositorio de documentación, la URL de un documento de esquema de AsyncAPI hospedado o un arreglo de enlaces a documentos de esquema de AsyncAPI. Mintlify generará automáticamente una página para cada canal de websocket de AsyncAPI.

**Ejemplos con Tabs:**

<CodeGroup>
  ```json Local File {5} theme={null}
  "navigation": {
    "tabs": [
      {
          "tab": "API Reference",
          "asyncapi": "/path/to/asyncapi.json"
      }
    ]
  }

  ```

  ```json Remote URL {5} theme={null}
  "navigation": {
    "tabs": [
      {
          "tab": "API Reference",
          "asyncapi": "https://github.com/asyncapi/spec/blob/master/examples/simple-asyncapi.yml"
      }
    ]
  }
  ```
</CodeGroup>

**Ejemplos con Groups:**

```json {8-11} theme={null}
"navigation": {
  "tabs": [
    {
      "tab": "AsyncAPI",
      "groups": [
        {
          "group": "Websockets",
          "asyncapi": {
            "source": "/path/to/asyncapi.json",
            "directory": "api-reference"
          }
        }
      ]
    }
  ]
}
```

<Note>
  El campo directory es opcional. Si no se especifica, los archivos se ubicarán en
  la carpeta **api-reference** del repositorio de docs.
</Note>

<div id="channel-page">
  ## Página de canal
</div>

Si quieres tener más control sobre el orden de tus canales, o si solo quieres hacer referencia a un canal específico, puedes crear un archivo MDX con el campo `asyncapi` en el frontmatter.

```mdx theme={null}
---
title: "Canal WebSocket"
asyncapi: "/path/to/asyncapi.json channelName"
---
```