n8n-nodes-blagues-api

n8n-nodes-blagues-api

Nœud communautaire n8n pour interagir avec Blagues API.

Description

Ce nœud permet de récupérer des blagues françaises depuis Blagues API en utilisant le module npm blagues-api.

Fonctionnalités

• Obtenir une blague aléatoire (avec option d'exclusion de catégories).
• Obtenir une blague aléatoire par catégorie spécifique.
• Obtenir une blague par son ID.
• Obtenir le nombre total de blagues disponibles.

Prérequis

• Un compte Blagues API et un token d'API valide.
• Une instance n8n en cours d'exécution.

Installation

Ce nœud est publié sur npm et peut être installé dans votre instance n8n.

Pour les instances n8n auto-hébergées (Docker, npm, etc.) :

• Ouvrez votre terminal.
• Naviguez jusqu'au répertoire de vos nœuds personnalisés n8n. Ce répertoire varie, mais il est souvent situé à ~/.n8n/custom/ ou un chemin similaire configuré dans votre docker-compose.yml ou vos variables d'environnement.
• Installez le nœud en utilisant npm ou pnpm :

  npm install n8n-nodes-blagues-api
  # ou
  pnpm install n8n-nodes-blagues-api
  

• Redémarrez votre instance n8n pour que le nouveau nœud soit pris en compte.

Pour n8n Cloud ou les installations sans accès au terminal (via l'interface) :

Actuellement, ce nœud est un "nœud communautaire". Pour qu'il soit installable directement depuis l'interface de n8n via l'explorateur de nœuds (comme les nœuds officiels ou vérifiés), il doit être soumis et vérifié par l'équipe n8n.

En attendant, l'installation manuelle via le terminal est la méthode principale pour les instances auto-hébergées.

Utilisation

Pour utiliser le nœud "Blagues API" dans votre workflow n8n :

• Dans n8n, cliquez sur le bouton + (Add new node) et recherchez "Blagues API".
• Ajoutez le nœud à votre workflow.
• Configurez vos identifiants (credentials) Blagues API en cliquant sur "Create New Credential" dans le nœud. Vous devrez fournir votre clé API (apiKey).
• Sélectionnez l'opération souhaitée (Get Random Joke, Get Random Categorized Joke, Get Joke by ID, Get Joke Count) et remplissez les paramètres nécessaires (par exemple, "Category" ou "Joke ID").
• Exécutez le nœud pour récupérer des blagues !

Contribution

Les contributions sont les bienvenues ! Si vous avez des améliorations, des corrections de bugs ou de nouvelles fonctionnalités à proposer, n'hésitez pas à ouvrir une issue ou à soumettre une Pull Request sur le dépôt GitHub du projet.

Licence

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.