Ressources · Intégration n8n

Intégration 1Shot API n8nAutomatiser 1Shot API avec n8n.

Signer une transaction blockchain depuis un workflow, sans jamais manipuler de clé privée ? C'est ce que permet l'intégration 1Shot API n8n. Le nœud expose 27 opérations réparties sur 7 ressources, des wallets aux méthodes de contrat, et son trigger webhook démarre le workflow dès que 1Shot envoie un événement.

Nœud communautaire Ce nœud n'est pas livré avec n8n : c'est un paquet communautaire (n8n-nodes-1shot) à installer depuis Settings › Community nodes sur une instance auto-hébergée. npm

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

Pourquoi monter l'intégration 1Shot API n8n ?

Une fois installé, le nœud transforme un appel de contrat EVM en étape de workflow ordinaire. Tu choisis un wallet géré par 1Shot, tu choisis une méthode de contrat, et n8n enchaîne comme avec n'importe quelle API.

Un trigger webhook complète le tableau : il écoute les événements que 1Shot envoie, comme la création ou la mise à jour d'un contract event, et les transmet directement à un workflow, sans aucun polling.

Premier usage, le reporting de trésorerie. wallets.list sort les wallets d'une chaîne, transactions.list sort ce qu'ils ont fait entre deux horodatages unix, et tout atterrit dans Google Sheets le vendredi matin. Rien de spectaculaire, juste un workflow planifié qui évite de recompiler les chiffres à la main.

Deuxième usage, la surveillance onchain. Tu déclares une fois ce qui t'intéresse avec contractEvents.create, puis contractEvents.search ramène les logs correspondants sur une plage de blocs. Un message part vers Slack quand un transfert dépasse le seuil que l'équipe finance a fixé, et l'historique complet se range dans MySQL.

Troisième usage, l'action déclenchée par un humain. Une demande arrive, contractMethods.simulate vérifie que l'appel passerait dans l'état actuel de la chaîne, et contractMethods.execute l'envoie pour de vrai. Si la simulation échoue, le workflow s'arrête avant d'avoir dépensé le moindre gas. C'est la différence entre une automatisation qui rate proprement et une qui brûle des frais pour rien.

Quand un endpoint de l'API 1Shot n'est pas couvert par le nœud, le nœud HTTP Request prend le relais. Il appelle n'importe quel endpoint en réutilisant le même credential via l'authentification prédéfinie, donc aucun secret n'est dupliqué dans le workflow.

Les limites, tout de suite. Les opérations de liste demandent Page Number et Page Size en champs obligatoires : pas de case Return All ici, un export complet se code avec une boucle sur les pages. Et le nœud reste sur le périmètre de l'API 1Shot, il ne lit pas la chaîne au-delà des méthodes et des événements que tu as déclarés. Si la partie n8n est encore nouvelle pour l'équipe, la Formation n8n couvre les notions utilisées ici.

Connexion

Comment connecter 1Shot API à n8n ?

  1. 01

    Installer le paquet communautaire

    Sur une instance auto-hébergée, ouvre Settings, puis Community nodes, et installe n8n-nodes-1shot en version 1.0.35. n8n redémarre et le nœud 1Shot API apparaît dans le panneau comme un nœud livré d'origine. Sur n8n Cloud, seuls les nœuds communautaires vérifiés s'installent, à vérifier avant de bâtir un plan dessus. Côté n8n, l'installation ne coûte rien.

  2. 02

    Créer le credential une seule fois

    Va dans le menu Credentials et crée le credential 1Shot avec les valeurs de ton compte. Un credential, dans n8n, c'est un jeu de secrets enregistré à part : tu le crées une fois, tous les workflows le réutilisent, et le nœud le propose dans sa liste déroulante. Ce que vaut chaque valeur et où la générer est documenté côté 1Shot, sur docs.1shotapi.com.

  3. 03

    Tester avec une lecture avant tout le reste

    Pose le nœud sur le canvas, prends la ressource Chain et l'opération List chains, mets Page Number à 1 et Page Size à une petite valeur, puis exécute l'étape. Si la liste des chaînes supportées revient, le credential fonctionne. Faire ça avant la première opération d'écriture évite de déboguer l'authentification et les paramètres de contrat en même temps.

Déclencheurs

Qu'est-ce qui déclenche un workflow depuis 1Shot API ?

1Shot API Webhook est le nœud qui démarre un workflow quand 1Shot API appelle n8n. Tu actives le workflow : n8n te donne l'URL du webhook à enregistrer dans 1Shot API, et chaque appel devient une exécution.

Ce que tu vois dans n8n

Notes de configuration

01Set up the 1Shot API Webhook triggerLe trigger 1Shot API Webhook démarre le workflow quand 1Shot envoie une requête sur l'URL n8n et que cette requête passe la vérification. Un webhook, c'est une URL que l'outil appelle quand il se passe quelque chose : l'événement arrive en quelques secondes, sans que n8n aille interroger l'API à intervalle régulier. Le workflow doit être actif pour que l'URL soit enregistrée côté outil.

Le trigger 1Shot API Webhook démarre le workflow quand 1Shot envoie une requête sur l'URL n8n et que cette requête passe la vérification. Un webhook, c'est une URL que l'outil appelle quand il se passe quelque chose : l'événement arrive en quelques secondes, sans que n8n aille interroger l'API à intervalle régulier. Le workflow doit être actif pour que l'URL soit enregistrée côté outil.

Paramètres clés

  • Public Key : la clé publique ED-25519 fournie par 1Shot pour vérifier le webhook. Champ obligatoire, sans lui le nœud ne s'exécute pas.
  • Webhook Type : choisit le type de vérification appliqué aux appels entrants.
  • Tokens : obligatoire aussi, il contient les tokens acceptés en paiement.
Cas d'usage
un point d'entrée payant qui ne lance le workflow que si l'appelant présente un token accepté et une signature valide.
02Shape the URL the trigger listens onDeux paramètres décident de la tête que doit avoir la requête entrante. Ça compte dès que 1Shot n'est pas le seul appelant, ou quand tu préfères un workflow par contrat plutôt qu'un workflow fourre-tout.

Deux paramètres décident de la tête que doit avoir la requête entrante. Ça compte dès que 1Shot n'est pas le seul appelant, ou quand tu préfères un workflow par contrat plutôt qu'un workflow fourre-tout.

Paramètres clés

  • Path : le chemin écouté. Les valeurs dynamiques s'écrivent avec deux points, du type your-path/:dynamic-value, et l'identifiant du webhook est alors ajouté devant le chemin.
  • HTTP Method : la méthode HTTP unique écoutée par le trigger.
  • Allow Multiple HTTP Methods : à activer quand le webhook doit accepter plusieurs méthodes HTTP.
Quand l'utiliser
donner un segment de chemin par contrat, pour que l'aiguillage se joue dans l'URL et pas dans un nœud IF plus bas. Une fois que des appelants pointent dessus, ce chemin ne bouge plus sans prévenir en face.
03Control what the trigger answersL'appelant reçoit une réponse HTTP, et son contenu se règle ici. C'est ce qu'on ajuste quand 1Shot attend un code précis, ou quand le workflow prend plus de temps que l'appelant n'est prêt à patienter.

L'appelant reçoit une réponse HTTP, et son contenu se règle ici. C'est ce qu'on ajuste quand 1Shot attend un code précis, ou quand le workflow prend plus de temps que l'appelant n'est prêt à patienter.

Paramètres clés

  • Respond : définit quand et comment le webhook répond.
  • Response Code : le code HTTP renvoyé à l'appelant.
  • Response Data : renvoyer tous les items sous forme de tableau, ou seulement le premier sous forme d'objet.
  • Options : la collection annexe du trigger, pour les réglages qui ne rentrent pas dans les champs ci-dessus.
Quand l'utiliser
répondre tout de suite puis faire le travail long, quand l'appelant coupe la connexion sur les exécutions qui durent. Ces trois champs servent aussi à renvoyer exactement le code que 1Shot attend, plutôt que de le laisser deviner.
Actions

Que sait faire le nœud 1Shot API ?

Le nœud 1Shot API expose 27 opérations sur 7 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

Matrice ressources × opérations
RessourceCreateGetUpdateDeleteAssure Contract Methods From PromptEncodeEstimateExecuteExecute as DelegatorExecute Batch as DelegatorExecute BatchList ChainsReadSearchSimulateX402 HTTP Request
X402 Request✓
Chain✓
Contract Event✓✓✓✓✓✓
Contract Method✓✓✓✓✓✓✓✓✓✓✓
Prompt✓
Transaction✓✓
Wallet✓✓✓✓✓

X402 Request

1 opération
01

X402 HTTP Request

x402Request.x402

Ce que tu vois dans n8n

Notes & cas d'usage

L'opération envoie une requête HTTP vers un endpoint compatible x402 et règle les frais éventuels depuis un wallet 1Shot. L'appel se comporte comme une requête HTTP classique, le paiement se joue en dessous.

Paramètres clés

  • Wallet Name or ID : le wallet qui paie, choisi dans la liste ou défini par expression.
  • URL : l'adresse appelée, du type http://example.com/index.html.
  • Credential Type et Generic Auth Type : la façon dont l'appel s'authentifie auprès de l'endpoint visé.
  • Method : GET, POST, PUT, PATCH, DELETE, HEAD ou OPTIONS.
Cas d'usage
interroger une API de données payante depuis un workflow, sans monter une étape de facturation séparée.

Chain

1 opération
02

List chains

chains.list

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les chaînes prises en charge par 1Shot API, page par page. C'est l'appel le moins risqué pour confirmer qu'un credential fonctionne avant de toucher à quoi que ce soit qui consomme du gas.

Paramètres clés

  • Page Number : la page voulue, la numérotation commence à 1.
  • Page Size : le nombre de chaînes renvoyées dans cette page.
Cas d'usage
alimenter la liste déroulante d'un formulaire interne, pour que personne ne saisisse une chaîne que 1Shot ne gère pas.

Contract Event

6 opérations
03

Create a contract event

contractEvents.create

Ce que tu vois dans n8n

Notes & cas d'usage

Enregistre une nouvelle définition d'événement de contrat dans 1Shot. C'est cette définition que les autres opérations ciblent ensuite : tant qu'elle n'existe pas, rien n'est surveillé.

Paramètres clés

  • Chain Name or ID : la chaîne sur laquelle vit le contrat.
  • Contract Address : l'adresse du contrat à surveiller.
  • Event Name : le nom exact de l'événement tel qu'il est défini dans l'ABI du contrat, casse comprise.
  • Name et Description : un nom lisible et une description de ce que représente l'événement, les deux obligatoires.
Cas d'usage
déclarer une fois la définition d'un transfert, pour qu'un workflow de reporting aille chercher ses logs chaque matin.
04

Delete a contract event

contractEvents.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime une définition d'événement de contrat. Elle disparaît de 1Shot, et tout workflow qui pointe encore sur cet identifiant tombera en erreur à sa prochaine exécution.

Paramètres clés

  • Contract Event Name or ID : la définition à supprimer, prise dans la liste ou fournie par une expression comme {{ $json.contractEventId }}.
Cas d'usage
faire le ménage après le redéploiement d'un contrat, pour que la liste proposée aux équipes reste courte et fiable.
05

Get a contract event

contractEvents.get

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère une seule définition d'événement avec ses détails enregistrés. Utile comme étape de contrôle plutôt que comme finalité.

Paramètres clés

  • Contract Event Name or ID : l'identifiant de la définition à lire.
Cas d'usage
avant une étape destructive, lire la définition et afficher son nom dans un message de validation, pour qu'un humain confirme de visu que c'est bien la bonne définition qui va partir.
06

List all contract events

contractEvents.list

Ce que tu vois dans n8n

Notes & cas d'usage

Parcourt tes définitions d'événements page par page, avec des filtres pour réduire le lot. C'est la vue inventaire, pas les logs de la blockchain.

Paramètres clés

  • Page Number et Page Size : obligatoires, et sans case Return All, donc une boucle si tu veux tout.
  • Name, Contract Address, Event Name, Chain Name or ID : les filtres optionnels sur les définitions renvoyées.
Cas d'usage
un audit hebdomadaire qui liste les définitions d'une chaîne et signale celles que plus personne n'interroge.
08

Update a contract event

contractEvents.update

Ce que tu vois dans n8n

Notes & cas d'usage

Modifie une définition existante sans la remplacer. Seuls ses libellés changent, donc l'identifiant utilisé par tes autres workflows continue de fonctionner.

Paramètres clés

  • Contract Event Name or ID : la définition à mettre à jour, obligatoire.
  • Name et Description : le nom et la description actualisés, les deux optionnels.
Cas d'usage
renommer une définition après un changement de convention interne, sans casser les workflows qui la référencent par son ID.

Contract Method

11 opérations
09

Assure contract methods from prompt

contractMethods.assureContractMethodsFromPrompt

Ce que tu vois dans n8n

Notes & cas d'usage

Garantit qu'un ensemble de méthodes de contrat est prêt à l'emploi à partir d'un Prompt choisi. Plutôt que de créer chaque méthode à la main, tu pointes un prompt et 1Shot prépare ce qui va avec.

Paramètres clés

  • Prompt ID : l'identifiant du Prompt servant de base.
  • Contract Address : obligatoire, et récupérable depuis le prompt si besoin.
  • Chain Name or ID : la chaîne où se trouve le contrat.
  • Wallet Name or ID : le wallet utilisé pour ces méthodes.
Cas d'usage
intégrer un nouveau contrat de token en une étape, au lieu de déclarer ses méthodes une par une.
10

Encode a smart contract method call

contractMethods.encode

Ce que tu vois dans n8n

Notes & cas d'usage

Produit le calldata d'une méthode de contrat sans rien envoyer. Certaines autres méthodes attendent ce calldata en entrée, et c'est précisément la raison d'être de l'opération.

Paramètres clés

  • Contract Method Name or ID : la méthode à encoder.
  • Parameters : un objet JSON avec les valeurs passées à la méthode, par exemple {"amount": "10000"}.
  • Authorization List : liste optionnelle d'autorisations ERC-7702 pour la méthode.
Cas d'usage
préparer l'appel interne d'un multicall, puis passer le résultat à la méthode qui le soumet vraiment.
11

Estimate the gas cost of a smart contract method

contractMethods.estimate

Ce que tu vois dans n8n

Notes & cas d'usage

Donne une estimation du coût en gas d'une méthode de contrat. Opération en lecture seule : elle ne change rien sur la chaîne et peut tourner aussi souvent que nécessaire.

Paramètres clés

  • Contract Method Name or ID : la méthode dont on chiffre le coût.
  • Parameters : l'objet JSON des valeurs, puisque le coût dépend de ce qu'on passe.
Cas d'usage
conditionner un versement automatique à un nœud IF, pour n'exécuter que si l'estimation reste sous le plafond validé en interne.
12

Execute a smart contract method

contractMethods.execute

Ce que tu vois dans n8n

Notes & cas d'usage

Envoie la transaction. C'est l'opération d'écriture du nœud, celle qu'on teste sur une chaîne de test avant de la laisser tourner dans un workflow planifié.

Paramètres clés

  • Contract Method Name or ID et Parameters : quoi appeler, et avec quelles valeurs.
  • Wallet ID : le wallet utilisé pour cette exécution, quand ce n'est pas celui par défaut.
  • Value : le montant de token natif envoyé avec la méthode.
  • Memo : un texte libre attaché à la transaction, précieux pour la réconciliation ensuite.
  • Gas Limit : c'est la plus élevée entre cette valeur et l'estimation qui sera retenue.
Cas d'usage
payer un prestataire onchain dès que sa facture est validée dans l'outil interne.
13

Execute a smart contract method as delegator

contractMethods.executeAsDelegator

Ce que tu vois dans n8n

Notes & cas d'usage

Exécute une méthode sur la blockchain via une délégation ERC-7710 enregistrée, donc pour le compte d'un autre wallet. C'est la délégation qui donne le droit, et elle se désigne d'une seule façon à la fois.

Paramètres clés

  • Delegation ID : le moyen le plus sûr de viser la bonne délégation.
  • Delegator Wallet Address : l'adresse du wallet délégant, au lieu d'un identifiant.
  • Delegation Data : un objet JSON de délégation traité comme usage unique, non conservé par 1Shot. Un seul de ces trois champs peut être rempli.
  • Contract Method Name or ID et Parameters : l'appel lui-même.
Cas d'usage
laisser une automatisation dépenser depuis un wallet de trésorerie sous une délégation signée à l'avance.
14

Execute multiple smart contract methods

contractMethods.executeBatch

Ce que tu vois dans n8n

Notes & cas d'usage

Regroupe plusieurs méthodes de contrat dans une seule transaction. Une soumission, un seul coût de gas, et un choix à faire sur ce qui arrive quand un des appels échoue.

Paramètres clés

  • Contract Methods : la collection d'appels, chacun avec son Contract Method Name or ID et ses Parameters.
  • Wallet Name or ID : le wallet utilisé pour tout le lot.
  • Atomic : activé, toutes les transactions du lot doivent réussir sous peine d'annulation complète.
  • Memo et Gas Limit : le texte attaché au lot, et le plancher de gas retenu.
Cas d'usage
solder en une transaction une série de versements collectés dans une feuille de calcul.
15

Execute multiple smart contract methods as delegator

contractMethods.executeAsDelegatorBatch

Ce que tu vois dans n8n

Notes & cas d'usage

Même logique de lot, mais en tant que délégataire. Plusieurs appels partent dans une transaction unique, pour le compte d'une adresse qui a délégué le droit d'agir.

Paramètres clés

  • Contract Methods et Wallet Name or ID : les appels, et le wallet qui les soumet.
  • Delegator Address, Delegation ID ou Delegation Data : un seul des trois désigne la délégation.
  • Atomic : décide si un échec unique annule tout le lot.
  • Authorization List : les autorisations ERC-7702 pour l'exécution du lot.
Cas d'usage
vider une file d'opérations déléguées une fois par jour, au lieu d'une transaction par élément.
16

Get a smart contract method

contractMethods.get

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie une méthode de contrat avec ses détails enregistrés. Particularité : aucun champ n'est obligatoire ici, ce qui est rare sur ce nœud.

Paramètres clés

  • Contract Method ID : l'identifiant de la méthode voulue. Il est optionnel, donc une valeur vide ne renverra rien d'exploitable plutôt que de lever une erreur.
Cas d'usage
transformer un identifiant reçu dans une charge utile entrante en détails lisibles, avant que le workflow décide de la suite.
17

List all smart contract methods

contractMethods.list

Ce que tu vois dans n8n

Notes & cas d'usage

Parcourt les méthodes de contrat déclarées, avec des filtres qui rendent le résultat exploitable. Celui sur le type de méthode est le plus rentable.

Paramètres clés

  • Page Number et Page Size : obligatoires à chaque appel.
  • Method Type : Read, Write, ou None pour désactiver le filtre.
  • Name, Contract Address, Prompt ID, Chain Name or ID : les autres filtres optionnels.
Cas d'usage
ne lister que les méthodes Write d'un contrat avant une revue des droits, pour ne pas faire relire tout le catalogue.
18

Read data from a smart contract function

contractMethods.read

Ce que tu vois dans n8n

Notes & cas d'usage

Lit une fonction view ou pure du contrat. Aucune transaction, aucun gas : juste une valeur qui revient dans le workflow.

Paramètres clés

  • Contract Method Name or ID : la méthode de lecture appelée.
  • Parameters : l'objet JSON des arguments attendus par la fonction.
Cas d'usage
vérifier un solde ou une autorisation en début de workflow, puis brancher pour que l'écriture coûteuse ne parte que si la valeur le justifie.
19

Simulate a smart contract method call

contractMethods.simulate

Ce que tu vois dans n8n

Notes & cas d'usage

Rejoue l'appel dans l'état actuel de la chaîne et indique s'il réussirait. À voir comme le test à blanc qu'on place devant chaque exécution réelle.

Paramètres clés

  • Contract Method Name or ID et Parameters : exactement ce que recevra l'étape d'exécution.
  • Gas Limit : optionnel, la limite par défaut s'applique si le champ reste vide.
Cas d'usage
détecter un revert dû à une autorisation manquante, avant que le workflow ne le découvre en dépensant du gas.

Prompt

1 opération

Transaction

2 opérations
21

List transactions

transactions.list

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les transactions 1Shot API sur une fenêtre de temps, avec une longue liste de filtres optionnels. Chaque appel est borné dans le temps, ce qui rend la planification sans danger.

Paramètres clés

  • After Time et Before Time : les horodatages unix qui encadrent la fenêtre, obligatoires tous les deux.
  • Page Number et Page Size : obligatoires également.
  • Status : Pending, Submitted, Completed, Retrying, Failed, ou None.
  • Wallet ID, Contract Method ID, API Credential ID, User ID, Memo, Chain Name or ID : les filtres optionnels.
Cas d'usage
un passage quotidien sur les transactions Failed qui ouvre un ticket au lieu d'attendre qu'on s'en aperçoive.
22

Get transaction

transactions.get

Ce que tu vois dans n8n

Notes & cas d'usage

Ramène une transaction précise. À combiner avec une attente ou une boucle quand tu veux suivre une soumission jusqu'à ce que son statut se stabilise.

Paramètres clés

  • Transaction Name or ID : l'identifiant de la transaction voulue, souvent {{ $json.id }} repris de l'étape d'exécution.
Cas d'usage
confirmer qu'un versement est passé en Completed avant de marquer la facture comme réglée dans l'outil comptable.

Wallet

5 opérations
23

Create wallet

wallets.create

Ce que tu vois dans n8n

Notes & cas d'usage

Un nouveau Wallet est créé, et il reste vide tant que tu n'y envoies pas de fonds. Le nom compte : c'est lui qui apparaîtra dans les listes déroulantes des autres opérations.

Paramètres clés

  • Chain Name or ID : la chaîne à laquelle le wallet appartient, choisie dans la liste ou posée par une expression.
  • Name : le nom du wallet, obligatoire.
  • Description : une description optionnelle du wallet.
Cas d'usage
ouvrir un wallet par mission cliente pour que la dépense reste lisible sans tableur tenu à côté.
24

Delete wallet

wallets.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime un Wallet. Rien d'autre n'est demandé, donc l'étape est définitive et mérite un garde-fou juste avant elle. Une opération qui pointe encore sur cet identifiant échouera à son prochain passage, donc mieux vaut nettoyer les workflows concernés dans la foulée.

Paramètres clés

  • Wallet Name or ID : le wallet à supprimer, pris dans la liste ou fourni par une expression du type {{ $json.walletId }}.
Cas d'usage
fermer le wallet d'un projet terminé une fois son solde déplacé ailleurs, dans un workflow de clôture qui archive aussi les lignes de transaction correspondantes.
25

Get wallet

wallets.get

Ce que tu vois dans n8n

Notes & cas d'usage

Va chercher un Wallet à partir de son identifiant et renvoie ce que 1Shot conserve à son sujet. Ici le champ est une simple chaîne de caractères, pas un menu déroulant.

Paramètres clés

  • Wallet Name or ID : l'identifiant du Wallet à récupérer, modifier ou supprimer, saisi directement ou construit par une expression.
Cas d'usage
vérifier le wallet visé par une demande entrante avant de laisser le workflow engager la moindre dépense.
26

List wallets

wallets.list

Ce que tu vois dans n8n

Notes & cas d'usage

Parcourt les Wallets d'une chaîne, page par page. Le filtre de chaîne reste optionnel : le laisser vide élargit le résultat au lieu de casser l'appel.

Paramètres clés

  • Page Number et Page Size : obligatoires tous les deux.
  • Chain Name or ID : un filtre optionnel sur la chaîne.
  • Name : filtre les wallets par nom.
Cas d'usage
un inventaire mensuel des wallets déposé dans un tableur pour l'équipe finance.
27

Update wallet

wallets.update

Ce que tu vois dans n8n

Notes & cas d'usage

Met à jour ce que 1Shot conserve d'un Wallet existant. L'identifiant ne bouge pas, les workflows qui le référencent continuent donc de tourner.

Paramètres clés

  • Wallet Name or ID : le wallet à modifier, obligatoire.
  • Name : le nom du wallet, obligatoire même pour une simple retouche.
  • Chain Name or ID et Description : les deux champs optionnels.
Cas d'usage
appliquer une nouvelle convention de nommage sur une série de wallets pilotée depuis un nœud Code.
Besoin d'aide

Besoin d'aide pour automatiser 1Shot API avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

1Shot API et n8n, les questions fréquentes

01L'intégration 1Shot API n8n est-elle gratuite ?
Oui côté n8n, avec une condition. Le nœud 1Shot API est un nœud communautaire : il n'est pas livré avec n8n, c'est le paquet npm n8n-nodes-1shot, qui s'installe depuis Settings puis Community nodes sur une instance auto-hébergée. Cette installation ne coûte rien. n8n Cloud n'accepte que les nœuds communautaires vérifiés, donc une instance Cloud n'est pas assurée de pouvoir l'installer. Ce que coûte 1Shot API en tant qu'outil est une autre question, qui n'est pas traitée ici. Pour le reste, un workflow se comporte de la même façon sur un serveur Docker maison ou sur n8n Cloud.
02Quels credentials faut-il pour le nœud 1Shot API ?
Un seul, créé une fois. Dans n8n, un credential est un jeu de secrets enregistré depuis le menu Credentials, réutilisable dans tous les workflows : le nœud le propose dans une liste déroulante, aucune clé ne se colle dans un nœud. L'opération X402 HTTP Request ajoute son propre choix par-dessus, avec les champs Credential Type et Generic Auth Type, parce que cet appel s'authentifie auprès de l'endpoint visé et pas auprès de 1Shot. Les valeurs exactes à saisir pour le credential 1Shot et l'endroit où les générer sont documentés sur docs.1shotapi.com.
03Quelles sont les limites du nœud 1Shot API ?
Deux points à connaître. La pagination d'abord : les opérations de liste exigent Page Number et Page Size, sans case Return All, donc un export complet demande une boucle sur les pages dans le workflow. Le périmètre ensuite : le nœud expose 27 opérations réparties sur 7 ressources, et ce qui sort de cette surface n'est pas accessible par lui. Quand il manque un endpoint, le nœud HTTP Request l'appelle directement en réutilisant le même credential via l'authentification prédéfinie, ce qui laisse un seul endroit où faire tourner les secrets.
04Le trigger 1Shot API Webhook réagit-il en temps réel ?
Oui. Le trigger fonctionne par webhook : c'est 1Shot qui appelle une URL n8n quand il se passe quelque chose, au lieu que n8n aille demander à intervalle régulier. n8n enregistre cette URL auprès de l'outil à l'activation du workflow, et chaque événement arrive en quelques secondes. La vérification fait partie du réglage : le trigger réclame une Public Key ED-25519 fournie par 1Shot, plus la collection Tokens qui liste ce qui est accepté en paiement. Une requête qui ne passe pas la vérification ne démarre pas le workflow.
05n8n ou Make pour 1Shot API ?
Ça dépend de quatre critères. L'hébergement : n8n tourne sur ton propre serveur en Docker ou npm, ou sur n8n Cloud, alors que Make est uniquement hébergé. La maîtrise des données : auto-héberger n8n garde les charges utiles et les credentials sur une infrastructure que tu contrôles, ce qui pèse quand il s'agit de wallets et de transactions. Le modèle de coût : Make facture à l'opération, et un workflow qui parcourt des pages de transactions grimpe vite avec le volume. La logique visuelle : les deux sont des éditeurs visuels, et Make reste confortable sur des branchements simples. Point propre à ce nœud : c'est un paquet communautaire, qu'une instance n8n auto-hébergée installe sans restriction.