工作流模板#

在创建新工作流时，您可以选择从空白工作流开始，或使用现有的模板。

模板提供：

帮助入门：n8n 可能已经有一个做您所需之事的模板。
您可以构建的例子
创建您自己的工作流的最佳实践

访问模板#

选择 View templates icon 模板来查看模板库。

如果您使用 n8n 的模板库，这将带您浏览 n8n 网站上的工作流。如果您使用组织提供的自定义库，您将能够在应用程序内搜索和浏览模板。

将您的工作流添加到 n8n 库#

您可以将工作流提交到 n8n 的模板库。

n8n 正在开发创作者计划，并构建模板市场。这是一个正在进行的项目，详细信息可能会发生变化。

请参阅 n8n Creator hub 了解如何提交模板并成为创作者的信息。

自托管 n8n：使用您自己的库#

在您的环境变量中，将 N8N_TEMPLATES_HOST 设置为您的 API 的基础 URL。

端点#

您的 API 必须提供与 n8n 相同的端点和数据结构。

端点包括：

Method	Path
GET	/templates/workflows/`<id>`
GET	/templates/search
GET	/templates/collections/`<id>`
GET	/templates/collections
GET	/templates/categories
GET	/health

查询参数#

/templates/search 端点接受以下查询参数：

参数	类型	描述
`page`	integer	要返回的结果页面
`rows`	integer	每页返回的最大结果数
`category`	comma-separated list of strings (categories)	要搜索的类别
`search`	string	搜索查询

/templates/collections 端点接受以下查询参数：

参数	类型	描述
`category`	comma-separated list of strings (categories)	要搜索的类别
`search`	string	搜索查询

数据模式#

您可以在此处探索端点返回的响应对象中项目的数据结构：

Show workflow item data schema

Workflow item data schema
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Generated schema for Root",
  "type": "object",
  "properties": {
    "id": {
      "type": "number"
    },
    "name": {
      "type": "string"
    },
    "totalViews": {
      "type": "number"
    },
    "price": {},
    "purchaseUrl": {},
    "recentViews": {
      "type": "number"
    },
    "createdAt": {
      "type": "string"
    },
    "user": {
      "type": "object",
      "properties": {
        "username": {
          "type": "string"
        },
        "verified": {
          "type": "boolean"
        }
      },
      "required": [
        "username",
        "verified"
      ]
    },
    "nodes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number"
          },
          "icon": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "codex": {
            "type": "object",
            "properties": {
              "data": {
                "type": "object",
                "properties": {
                  "details": {
                    "type": "string"
                  },
                  "resources": {
                    "type": "object",
                    "properties": {
                      "generic": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "url": {
                              "type": "string"
                            },
                            "icon": {
                              "type": "string"
                            },
                            "label": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "url",
                            "label"
                          ]
                        }
                      },
                      "primaryDocumentation": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "url": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "url"
                          ]
                        }
                      }
                    },
                    "required": [
                      "primaryDocumentation"
                    ]
                  },
                  "categories": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "nodeVersion": {
                    "type": "string"
                  },
                  "codexVersion": {
                    "type": "string"
                  }
                },
                "required": [
                  "categories"
                ]
              }
            }
          },
          "group": {
            "type": "string"
          },
          "defaults": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "color": {
                "type": "string"
              }
            },
            "required": [
              "name"
            ]
          },
          "iconData": {
            "type": "object",
            "properties": {
              "icon": {
                "type": "string"
              },
              "type": {
                "type": "string"
              },
              "fileBuffer": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ]
          },
          "displayName": {
            "type": "string"
          },
          "typeVersion": {
            "type": "number"
          },
          "nodeCategories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "number"
                },
                "name": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "name"
              ]
            }
          }
        },
        "required": [
          "id",
          "icon",
          "name",
          "codex",
          "group",
          "defaults",
          "iconData",
          "displayName",
          "typeVersion"
        ]
      }
    }
  },
  "required": [
    "id",
    "name",
    "totalViews",
    "price",
    "purchaseUrl",
    "recentViews",
    "createdAt",
    "user",
    "nodes"
  ]
}

Show category item data schema

Category item data schema
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "id": {
      "type": "number"
    },
    "name": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "name"
  ]
}

Show collection item data schema

Collection item data schema
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "id": {
      "type": "number"
    },
    "rank": {
      "type": "number"
    },
    "name": {
      "type": "string"
    },
    "totalViews": {},
    "createdAt": {
      "type": "string"
    },
    "workflows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number"
          }
        },
        "required": [
          "id"
        ]
      }
    },
    "nodes": {
      "type": "array",
      "items": {}
    }
  },
  "required": [
    "id",
    "rank",
    "name",
    "totalViews",
    "createdAt",
    "workflows",
    "nodes"
  ]
}