Usar el generador de OpenAPI:
- Título: En el campo "Título", ingresa el nombre de tu API o el título del esquema que deseas crear.
- Descripción: Proporciona una descripción detallada de lo que hace tu API o de los datos que el esquema representará.
- Webhook URL: Aquí ingresarías la URL al Webhook de N8N que se deben enviar los eventos.
- Método HTTP: Selecciona el método HTTP adecuado para tu operación de API. Por ejemplo, "GET" para recuperar datos, "POST" para crear datos.
- Añadir Parámetro: Haz clic en el botón "Añadir Parámetro" si tu operación requiere parámetros. Esto puede incluir parámetros de consulta y su descripción.
- Generar OpenAPI: Una vez que hayas ingresado toda la información requerida y los parámetros, haz clic en el botón "Generar OpenAPI" para crear el esquema de OpenAPI. Este esquema es una especificación estándar para describir APIs RESTful y puede ser utilizado para generar documentación, bibliotecas cliente, y más.
- El esquema de OpenAPI resultante te proporcionará un documento estructurado en formato YAML que describe tu API, sus endpoints, los métodos HTTP admitidos, los parámetros esperados, y los formatos de los mensajes de respuesta.