API Documentation

Intégrez facilement les workflows n8n dans vos applications

API Online
Version 1.0
REST API

Introduction

L'API n8n Workflow Hub vous permet d'accéder programmatiquement à notre collection de workflows. Utilisez cette API pour intégrer les workflows dans vos applications, automatiser les téléchargements, ou créer vos propres interfaces.

Base URL
https://n8nup.fr//api/v1

Format des réponses

Toutes les réponses sont au format JSON avec UTF-8 encoding.

Structure de réponse standard
{ "success": true, "data": {...}, "meta": { "page": 1, "limit": 20, "total": 100 } }

Authentication

L'API publique ne nécessite pas d'authentification pour les opérations de lecture. Pour les opérations d'écriture (POST, PUT, DELETE), une clé API est requise.

Header d'authentification
X-API-Key: your-api-key-here
Les clés API sont disponibles sur demande. Contactez l'administrateur pour obtenir une clé.

Endpoints

GET /workflows

Récupère la liste de tous les workflows avec pagination.

Paramètres de requête
page integer Numéro de page (défaut: 1)
limit integer Nombre de résultats par page (défaut: 20, max: 100)
sort string Ordre de tri: recent, popular, downloads (défaut: recent)
category integer ID de la catégorie pour filtrer
Exemple de requête
curl -X GET 'https://n8nup.fr//api/v1/workflows?page=1&limit=10&sort=popular'
Réponse
{ "success": true, "data": [ { "id": 1, "title": "Email Automation Workflow", "description": "Automate email responses based on keywords", "category_id": 3, "category_name": "Email & Communication", "views": 1250, "downloads": 342, "created_at": "2024-01-15T10:30:00Z", "updated_at": "2024-01-20T14:22:00Z" } ], "meta": { "page": 1, "limit": 10, "total": 156, "total_pages": 16 } }
GET /workflows/{id}

Récupère les détails complets d'un workflow spécifique.

Paramètres de route
id integer ID unique du workflow
Exemple de requête
curl -X GET 'https://n8nup.fr//api/v1/workflows/1'
POST /workflows

Crée un nouveau workflow. Nécessite une authentification.

Body Parameters (JSON)
title string Titre du workflow (requis)
description string Description détaillée (requis)
category_id integer ID de la catégorie (requis)
json_data object Données JSON du workflow n8n (requis)
Exemple de requête
curl -X POST 'https://n8nup.fr//api/v1/workflows' \ -H 'Content-Type: application/json' \ -H 'X-API-Key: your-api-key' \ -d '{ "title": "My Workflow", "description": "This workflow does...", "category_id": 1, "json_data": {...} }'

Gestion des Erreurs

L'API utilise les codes de statut HTTP standards pour indiquer le succès ou l'échec d'une requête.

200 OK Success La requête a réussi
201 Created Success Ressource créée avec succès
400 Bad Request Error Paramètres invalides
401 Unauthorized Error Authentification requise
404 Not Found Error Ressource non trouvée
429 Too Many Requests Error Limite de taux dépassée
500 Internal Server Error Error Erreur serveur
Format d'erreur
{ "success": false, "error": { "code": "RESOURCE_NOT_FOUND", "message": "The requested workflow was not found", "details": { "id": 999 } } }

Rate Limiting

Pour garantir la qualité du service, l'API applique des limites de taux par IP.

Limites actuelles
• 100 requêtes par minute pour les endpoints publics
• 1000 requêtes par minute avec authentification
• Les headers de réponse incluent les informations de limite
Headers de rate limiting
X-RateLimit-Limit: 100 X-RateLimit-Remaining: 95 X-RateLimit-Reset: 1642089600

Testeur d'API

Testez les endpoints directement depuis cette page.