API Connector

Le node API Connector envoie des requêtes HTTP vers n'importe quelle API externe et expose la réponse pour que la suite du workflow puisse l'exploiter.

À quoi sert le node API Connector ?

Le node API Connector exécute une requête HTTP vers n’importe quelle URL (GET, POST, PUT, PATCH, DELETE) et expose la réponse complète (body, headers, code de statut) aux nodes suivants. C’est l’échappatoire universelle quand aucun node d’intégration dédié n’existe pour le service que vous voulez appeler.

Cas d’usage typiques :

• Récupérer des données depuis une API REST tierce sans node natif (CRM, microservice interne, jeu de données public).
• Envoyer la sortie d’un workflow vers un webhook (Slack, Zapier, listener sur-mesure) à la fin d’une étape LLM.
• Déclencher des actions côté serveur sur votre propre backend avec un payload modélisé qui dépend des nodes précédents.

Configuration rapide

Suivez ces étapes pour ajouter et configurer le node API Connector dans votre workflow :

Paramètres de configuration

Champs requis

Champs optionnels

Que renvoie le node ?

Le node renvoie la réponse HTTP brute en JSON. Reliez le port de sortie au node suivant et créez-y une variable pour la récupérer.

Exemples d’utilisation

Cas 1 : Requête GET avec bearer token

Récupérer une fiche utilisateur depuis une API REST privée.

Configuration :

• Method : GET
• Url : https://api.example.com/v1/users/{{user_id}}
• Authorization : clé Authorization, valeur Bearer {{api_token}}
• Content Type : JSON
• Parameters : (vide)

Output (dans api_response) :

{
  "body": { "id": "u_42", "email": "alice@example.com", "plan": "pro" },
  "headers": { "content-type": "application/json" },
  "status_code": 200
}

Cas 2 : POST d’un payload JSON vers un webhook

Envoyer un résumé structuré produit par un LLM en amont vers un webhook entrant Slack.

Configuration :

• Method : POST
• Url : https://hooks.slack.com/services/T000/B000/XXX
• Headers : (vide)
• Content Type : JSON
• Parameters :
  • clé text, valeur {{summary}}
  • clé channel, valeur #alerts

Le runner sérialise les paramètres en {"text": "...", "channel": "#alerts"} et les poste. Slack répond status_code: 200 avec un body ok.

Problèmes courants

Le node échoue avec `Missing url on HTTPRequest Tool`

Cause : Le champ Url est vide, ou son template référence une variable qui s’est résolue en chaîne vide.

Solution : Renseignez Url avec une URL littérale ou vérifiez que chaque {{variable}} qu’il utilise provient d’un node connecté en amont produisant une valeur non vide.

Le serveur renvoie 401 / 403 alors que le token marche dans Postman

Cause : La valeur d’Authorization n’a pas le préfixe Bearer , ou la variable contenant le token contient des espaces parasites, ou vous avez mis le token dans Headers avec une mauvaise clé.

Solution : Mettez le credential dans le bloc Authorization avec la clé Authorization et la valeur Bearer {{token}}. Nettoyez le token à la source. Inspectez l’exécution pour confirmer que le header fusionné atteint le serveur.

Mon body JSON arrive comme une chaîne entre guillemets au lieu d'un objet

Cause : La valeur dans Parameters ressemble à du JSON mais contient une erreur de syntaxe (apostrophes, virgule traînante), donc le runner retombe sur l’envoi en tant que chaîne.

Solution : Validez le JSON en amont (un node LLM produit souvent du JSON malformé — nettoyez-le avec un Find and Replace ou un JSON Path Extractor avant). Les clés et valeurs doivent être encadrées par des guillemets doubles.

Status code 200 mais le node suivant voit un body vide

Cause : Le serveur a renvoyé un body non-JSON (page HTML d’erreur, texte brut) et le node aval attend un objet.

Solution : Lisez d’abord status_code et headers.content-type avec un node Conditional, puis branchez en conséquence. Pour les réponses textuelles, consommez body comme une chaîne.

Bonnes pratiques et pièges à éviter

Comment s’intègre-t-il dans un workflow ?

L’API Connector se place typiquement à la frontière du workflow — soit pour faire entrer de la donnée au début, soit pour pousser les résultats à la fin.

graph LR
    Input[Input Texte] --> LLM[Node LLM génère le payload]
    LLM --> API[API Connector
<br/>POST /webhook]
    API --> Cond[Conditional sur status_code]
    Cond --> Done[Fin]

Nodes complémentaires