Configuración de AsyncAPI

Agrega un archivo de especificación de AsyncAPI

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. Tu esquema debe ajustarse a la especificación 3.0+ de AsyncAPI.

Para comprobar que tu esquema de AsyncAPI sea válido, puedes pegarlo en AsyncAPI Studio

Autogenerar páginas de websockets

Puedes agregar un campo asyncapi a cualquier pestaña o grupo en la navegación 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 alojado o una matriz de enlaces a documentos de esquema de AsyncAPI. Mintlify generará automáticamente una página para cada canal de websocket de AsyncAPI. Ejemplos con pestañas:

"navigation": {
  "tabs": [
    {
        "tab": "API Reference",
        "asyncapi": "/path/to/asyncapi.json"
    }
  ]
}

"navigation": {
  "tabs": [
    {
        "tab": "API Reference",
        "asyncapi": "https://github.com/asyncapi/spec/blob/master/examples/simple-asyncapi.yml"
    }
  ]
}

Ejemplos con grupos:

"navigation": {
  "tabs": [
    {
      "tab": "AsyncAPI",
      "groups": [
        {
          "group": "WebSockets",
          "asyncapi": {
            "source": "/path/to/asyncapi.json",
            "directory": "referencia-api"
          }
        }
      ]
    }
  ]
}

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

Página de canal

Si quieres tener más control sobre el orden de tus canales o simplemente referenciar un canal específico, puedes crear un archivo MDX con el campo asyncapi en el frontmatter.

---
title: "Canal WebSocket"
asyncapi: "/path/to/asyncapi.json channelName"
---

⌘I

Primeros pasos

Configuración principal

Optimización de IA

Componentes

Páginas de API

Autenticación y personalización

Guías

Integraciones

Control de versiones y CI/CD

Configuración de AsyncAPI

Agrega un archivo de especificación de AsyncAPI

Autogenerar páginas de websockets

Página de canal

​Agrega un archivo de especificación de AsyncAPI

​Autogenerar páginas de websockets

​Página de canal

Agrega un archivo de especificación de AsyncAPI

Autogenerar páginas de websockets

Página de canal