Templates

Workflow-Templates

Beim Erstellen eines neuen Workflows können Sie wählen, ob Sie mit einem leeren Workflow beginnen oder ein vorhandenes Template verwenden möchten.

Templates bieten:

• Hilfe beim Einstieg: Möglicherweise gibt es bereits ein Template in n8n, das genau das tut, was Sie benötigen.
• Beispiele dafür, was Sie bauen können
• Best Practices für die Erstellung eigener Workflows

Zugriff auf Templates

Wählen Sie das Symbol Templates, um die Template-Bibliothek anzuzeigen.

Wenn Sie die offizielle Template-Bibliothek von n8n nutzen, gelangen Sie zur Übersicht der Workflows auf der n8n-Website. Falls Ihre Organisation eine eigene, benutzerdefinierte Bibliothek bereitstellt, können Sie die Templates direkt innerhalb der Anwendung durchsuchen.

Fügen Sie Ihren Workflow der n8n-Bibliothek hinzu

n8n arbeitet aktuell an einem Creator-Programm und entwickelt einen Marktplatz für Templates. Dies ist ein laufendes Projekt, und Details können sich noch ändern.

Selbstgehostetes n8n: Verwenden Sie Ihre eigene Bibliothek

Setzen Sie in Ihren Umgebungsvariablen die Variable N8N_TEMPLATES_HOST auf die Basis-URL Ihrer API.

Endpunkte

Ihre API muss dieselben Endpunkte und Datenstrukturen wie die offizielle n8n-API bereitstellen.

Die erforderlichen Endpunkte sind:

Methode	Pfad	Zweck
GET	/templates/workflows/	Ruft Metadaten der Templates zur Vorschau/Navigation ab
GET	/workflows/templates/	Ruft Workflow-Daten zum Import auf den Canvas ab
GET	/templates/search	Durchsucht Workflow-Templates
GET	/templates/collections/	Ruft eine bestimmte Template-Sammlung ab
GET	/templates/collections	Listet alle Template-Sammlungen auf
GET	/templates/categories	Listet alle Template-Kategorien auf
GET	/health	Health-Check-Endpunkt

Wichtig: Zwei unterschiedliche Antwortformate erforderlich

Die beiden Workflow-Endpunkte erfordern unterschiedliche Antwortformate:

• /templates/workflows/: Gibt Metadaten mit dem Workflow unter dem Schlüssel workflow zurück.
• /workflows/templates/: Gibt nur den Workflow-JSON zurück.

Weitere Details finden Sie in den Schemas unten.

Abfrageparameter

Der Endpunkt /templates/search akzeptiert folgende Abfrageparameter:

Parameter	Typ	Beschreibung
page	Ganzzahl	Die Seite der Ergebnisse, die zurückgegeben werden soll
rows	Ganzzahl	Maximale Anzahl der Ergebnisse pro Seite
category	Kommagetrennte Liste von Zeichenketten (Kategorien)	Die Kategorien, innerhalb derer gesucht werden soll
search	Zeichenkette	Die Suchanfrage

Der Endpunkt /templates/collections akzeptiert folgende Abfrageparameter:

Parameter	Typ	Beschreibung
category	Kommagetrennte Liste von Zeichenketten (Kategorien)	Die Kategorien, innerhalb derer gesucht werden soll
search	Zeichenkette	Die Suchanfrage

Schemas

Der wesentliche Unterschied zwischen den beiden Workflow-Endpunkten:

// GET /templates/workflows/ gibt Metadaten mit eingebettetem Workflow zurück

// GET /workflows/templates/ gibt nur den Workflow-JSON zurück

Detaillierte Schemas für Antwortobjekte:

Schema für workflow-Elementdaten anzeigen

Wird vom Endpunkt /templates/workflows/ verwendet (eingebettet unter dem Schlüssel workflow).

Dieses Schema beschreibt die Template-Metadaten, die zur Anzeige in der Such- und Navigations-Oberfläche dienen. Es enthält eine verschachtelte workflow-Eigenschaft, die die eigentliche importierbare Workflow-Definition beinhaltet.

Schema für Workflow-Elementdaten

(Hinweis: Die folgenden Schemas zeigen die Struktur der Antwortobjekte. Platzhalter wie "name": repräsentieren Felder mit entsprechenden Werten.)

,
    "name": ,
    "totalViews": ,
    "price": ,
    "purchaseUrl": ,
    "recentViews": ,
    "createdAt": ,
    "user": ,
        "verified": 
      },
      "required": [
        "username",
        "verified"
      ]
    },
    "nodes": ,
          "icon": ,
          "name": ,
          "codex": ,
                  "resources": ,
                            "icon": ,
                            "label": 
                          },
                          "required": [
                            "url",
                            "label"
                          ]
                        }
                      },
                      "primaryDocumentation": 
                          },
                          "required": [
                            "url"
                          ]
                        }
                      }
                    },
                    "required": [
                      "primaryDocumentation"
                    ]
                  },
                  "categories": 
                  },
                  "nodeVersion": ,
                  "codexVersion": 
                },
                "required": [
                  "categories"
                ]
              }
            }
          },
          "group": ,
          "defaults": ,
              "color": 
            },
            "required": [
              "name"
            ]
          },
          "iconData": ,
              "type": ,
              "fileBuffer": 
            },
            "required": [
              "type"
            ]
          },
          "displayName": ,
          "typeVersion": ,
          "nodeCategories": ,
                "name": 
              },
              "required": [
                "id",
                "name"
              ]
            }
          }
        },
        "required": [
          "id",
          "icon",
          "name",
          "codex",
          "group",
          "defaults",
          "iconData",
          "displayName",
          "typeVersion"
        ]
      }
    },
    "description": ,
    "image": ,
          "url": 
        }
      }
    },
    "categories": ,
          "name": 
        }
      }
    },
    "workflowInfo": ,
        "nodeTypes": 
      }
    },
    "workflow": ,
        "connections": ,
        "settings": ,
        "pinData": 
      },
      "required": [
        "nodes",
        "connections"
      ]
    }
  },
  "required": [
    "id",
    "name",
    "totalViews",
    "createdAt",
    "user",
    "nodes",
    "workflow"
  ]
}

Schema für category-Elementdaten anzeigen

Schema für Kategorie-Elementdaten

,
    "name": 
  },
  "required": [
    "id",
    "name"
  ]
}

Schema für collection-Elementdaten anzeigen

Schema für Sammlungs-Elementdaten

,
    "rank": ,
    "name": ,
    "totalViews": ,
    "createdAt": ,
    "workflows": 
        },
        "required": [
          "id"
        ]
      }
    },
    "nodes": 
    }
  },
  "required": [
    "id",
    "rank",
    "name",
    "totalViews",
    "createdAt",
    "workflows",
    "nodes"
  ]
}

Sie können die API-Endpunkte von n8n auch interaktiv erkunden:

https://api.n8n.io/templates/categories
https://api.n8n.io/templates/collections
https://api.n8n.io/templates/search
https://api.n8n.io/health

Bei weiteren Fragen kontaktieren Sie uns gerne.