Plantillas
Plantillas de flujos de trabajo
Al crear un nuevo flujo de trabajo, puedes elegir si comenzar con un flujo de trabajo vacío o utilizar una plantilla existente.
Las plantillas ofrecen:
- Ayuda para empezar: es posible que n8n ya tenga una plantilla que haga exactamente lo que necesitas.
- Ejemplos de lo que puedes construir
- Prácticas recomendadas para crear tus propios flujos de trabajo
Acceder a las plantillas
Selecciona
Plantillas para ver la biblioteca de plantillas.
Si utilizas la biblioteca de plantillas de n8n, se te redirigirá al sitio web de n8n para explorar los Flujos de trabajo disponibles. Si tu organización proporciona una biblioteca personalizada, podrás buscar y navegar entre las plantillas directamente en la aplicación.
Añadir tu flujo de trabajo a la biblioteca de n8n
n8n está trabajando en un programa para creadores y desarrollando un marketplace de plantillas. Este es un proyecto en curso y es probable que los detalles cambien.
n8n autohospedado: Usa tu propia biblioteca
En tus variables de entorno, establece N8N_TEMPLATES_HOST con la URL base de tu API.
Endpoints
Tu API debe proporcionar los mismos endpoints y estructura de datos que n8n.
Los endpoints son:
| Método | Ruta | Propósito |
|---|---|---|
| GET | /templates/workflows/ | Obtener metadatos de la plantilla para previsualización o navegación |
| GET | /workflows/templates/ | Obtener los datos del flujo de trabajo para importar en el lienzo |
| GET | /templates/search | Buscar plantillas de flujos de trabajo |
| GET | /templates/collections/ | Obtener una colección específica de plantillas |
| GET | /templates/collections | Listar todas las colecciones de plantillas |
| GET | /templates/categories | Listar todas las categorías de plantillas |
| GET | /health | Endpoint de verificación de estado (health check) |
Importante: Se requieren dos formatos de respuesta diferentes
Los dos endpoints relacionados con flujos de trabajo requieren formatos de respuesta distintos:
/templates/workflows/: Devuelve la plantilla completa, incluyendo el flujo de trabajo en la claveworkflow/workflows/templates/: Devuelve directamente el objeto del flujo de trabajo (sin envoltura adicional)
Consulta los esquemas a continuación para más detalles.
Parámetros de consulta
El endpoint /templates/search acepta los siguientes parámetros de consulta:
| Parámetro | Tipo | Descripción |
|---|---|---|
page | entero | La página de resultados a devolver |
rows | entero | El número máximo de resultados por página |
category | lista de cadenas separadas por comas (categorías) | Las categorías en las que buscar |
search | cadena | La consulta de búsqueda |
El endpoint /templates/collections acepta los siguientes parámetros de consulta:
| Parámetro | Tipo | Descripción |
|---|---|---|
category | lista de cadenas separadas por comas (categorías) | Las categorías en las que buscar |
search | cadena | La consulta de búsqueda |
Esquemas
La diferencia clave entre los dos endpoints de flujos de trabajo:
| // GET /templates/workflows/ devuelve (respuesta envuelta):
{ "id": "...", "name": "...", ... "workflow": { "nodes": [...], "connections": {...} } }
// GET /workflows/templates/ devuelve (respuesta plana):
{ "nodes": [...], "connections": {...} }
---|---
Esquemas detallados de los objetos de respuesta:
Mostrar esquema de datos del elemento workflow
Utilizado por el endpoint /templates/workflows/ (envuelto en una clave workflow).
Este esquema describe los metadatos de la plantilla usados para mostrar las plantillas en la interfaz de búsqueda/navegación. Incluye una propiedad anidada workflow que contiene la definición real del flujo de trabajo que se puede importar.
Esquema de datos del elemento workflow
{ "id": "...", "name": "...", "totalViews": ..., "price": ..., "purchaseUrl": "...", "recentViews": ..., "createdAt": "...", "user": { "username": "...", "verified": true }, "nodes": [ { "id": "...", "icon": "...", "name": "...", "codex": { "resources": [ { "url": "...", "icon": "...", "label": "..." } ], "primaryDocumentation": { "url": "..." } }, "categories": ["..."], "nodeVersion": ..., "codexVersion": ..., "group": "...", "defaults": { "name": "...", "color": "..." }, "iconData": { "type": "...", "fileBuffer": "..." }, "displayName": "...", "typeVersion": ..., "nodeCategories": [ { "id": "...", "name": "..." } ] } ], "description": "...", "image": { "url": "..." }, "categories": [ { "id": "...", "name": "..." } ], "workflowInfo": { "nodeTypes": [...] }, "workflow": { "nodes": [...], "connections": {...}, "settings": {...}, "pinData": {...} } }
Mostrar esquema de datos del elemento category
Esquema de datos del elemento category
{ "id": "...", "name": "..." }
Mostrar esquema de datos del elemento collection
Esquema de datos del elemento collection
{ "id": "...", "rank": ..., "name": "...", "totalViews": ..., "createdAt": "...", "workflows": [ { "id": "..." } ], "nodes": [...] }
También puedes explorar interactivamente los endpoints de la API de n8n en las siguientes direcciones:
https://api.n8n.io/templates/categories
https://api.n8n.io/templates/collections
https://api.n8n.io/templates/search
https://api.n8n.io/health
Puedes contactarnos si necesitas más ayuda.