Modèles

Modèles de flux de travail

Lorsque vous créez un nouveau flux de travail, vous pouvez choisir de démarrer avec un flux de travail vide ou d’utiliser un modèle existant.

Les modèles offrent les avantages suivants :

Une aide pour bien démarrer : n8n dispose peut-être déjà d’un modèle répondant à vos besoins.
Des exemples concrets de ce que vous pouvez construire.
Des bonnes pratiques pour créer vos propres flux de travail.

Accéder aux modèles

Sélectionnez l’icône Templates pour accéder à la bibliothèque de modèles.

Si vous utilisez la bibliothèque officielle de n8n, vous serez redirigé vers la page Workflows sur le site web de n8n. Si votre organisation fournit une bibliothèque personnalisée, vous pourrez rechercher et parcourir les modèles directement dans l’application.

Ajouter votre flux de travail à la bibliothèque de n8n

n8n travaille actuellement sur un programme destiné aux créateurs ainsi qu’au développement d’une marketplace de modèles. Il s’agit d’un projet en cours, et les détails sont susceptibles d’évoluer.

n8n auto-hébergé : Utiliser votre propre bibliothèque

Dans vos variables d’environnement, définissez la variable N8N_TEMPLATES_HOST sur l’URL de base de votre API.

Endpoints

Votre API doit fournir les mêmes endpoints et la même structure de données que ceux de n8n.

Voici la liste des endpoints requis :

Méthode	Chemin	Objectif
GET	`/templates/workflows/`	Obtenir les métadonnées des modèles (pour aperçu et navigation)
GET	`/workflows/templates/`	Récupérer les données du flux de travail afin de l’importer sur le canevas
GET	`/templates/search`	Rechercher des modèles de flux de travail
GET	`/templates/collections/`	Obtenir une collection spécifique de modèles
GET	`/templates/collections`	Lister toutes les collections de modèles
GET	`/templates/categories`	Lister toutes les catégories de modèles
GET	`/health`	Endpoint de vérification de l’état de santé

Important : Deux formats de réponse différents requis

Les deux endpoints relatifs aux flux de travail nécessitent des formats de réponse différents :

/templates/workflows/ : Renvoie le modèle lui-même, incluant le flux de travail dans la clé workflow.
/workflows/templates/ : Renvoie uniquement le flux de travail contenu dans le modèle.

Voir les schémas ci-dessous pour plus de détails.

Paramètres de requête

L’endpoint /templates/search accepte les paramètres de requête suivants :

Paramètre	Type	Description
`page`	entier	La page de résultats à renvoyer
`rows`	entier	Le nombre maximum de résultats par page
`category`	liste de chaînes séparées par des virgules (catégories)	Les catégories dans lesquelles effectuer la recherche
`search`	chaîne	La requête de recherche

L’endpoint /templates/collections accepte les paramètres de requête suivants :

Paramètre	Type	Description
`category`	liste de chaînes séparées par des virgules (catégories)	Les catégories dans lesquelles effectuer la recherche
`search`	chaîne	La requête de recherche

Schémas

La principale différence entre les deux endpoints de flux de travail :

// GET /templates/workflows/ returns (wrapped):

    }
  }
}

// GET /workflows/templates/ returns (flat):

  }
}
  

---|---

Schémas détaillés des objets de réponse :

Afficher le schéma des données d’un élément workflow

Utilisé par l’endpoint /templates/workflows/ (encapsulé dans une clé workflow).

Ce schéma décrit les métadonnées du modèle utilisées pour l’affichage dans l’interface de recherche/navigation. Il inclut une propriété imbriquée workflow contenant la définition réelle du flux de travail importable.

Schéma des données d’un élément `workflow`

,
    "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"
  ]
}
  

Afficher le schéma des données d’un élément category

Schéma des données d’un élément `category`

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

Afficher le schéma des données d’un élément collection

Schéma des données d’un élément `collection`

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

Vous pouvez également explorer de manière interactive les endpoints de l’API de n8n :

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

N’hésitez pas à nous contacter si vous avez besoin d’aide supplémentaire.

Modèles de flux de travail

Accéder aux modèles​

Ajouter votre flux de travail à la bibliothèque de n8n​

n8n auto-hébergé : Utiliser votre propre bibliothèque​

Endpoints​

Paramètres de requête​

Schémas​

Schéma des données d’un élément workflow​

Schéma des données d’un élément category​

Schéma des données d’un élément collection​