API

Le bloc API vous permet de connecter votre flux de travail à des services externes via des points de terminaison API en utilisant des requêtes HTTP. Il prend en charge diverses méthodes comme GET, POST, PUT, DELETE et PATCH, vous permettant d'interagir avec pratiquement n'importe quel point de terminaison API.

Aperçu

Le bloc API vous permet de :

Comment ça fonctionne

Le bloc API traite les requêtes HTTP selon une approche structurée :

1. Configuration de la requête - Définir l'URL, la méthode, les en-têtes et les paramètres du corps
2. Exécution de la requête - Envoyer la requête HTTP au point de terminaison spécifié
3. Traitement de la réponse - Gérer les données de réponse, les codes d'état et les en-têtes
4. Gestion des erreurs - Gérer les délais d'attente, les nouvelles tentatives et les conditions d'erreur

Options de configuration

URL

L'URL du point de terminaison pour la requête API. Cela peut être :

• Une URL statique saisie directement dans le bloc
• Une URL dynamique connectée depuis la sortie d'un autre bloc
• Une URL avec des paramètres de chemin

Méthode

Sélectionnez la méthode HTTP pour votre requête :

• GET : récupérer des données du serveur
• POST : envoyer des données au serveur pour créer une ressource
• PUT : mettre à jour une ressource existante sur le serveur
• DELETE : supprimer une ressource du serveur
• PATCH : mettre à jour partiellement une ressource existante

Paramètres de requête

Définissez des paires clé-valeur qui seront ajoutées à l'URL comme paramètres de requête. Par exemple :

Key: apiKey
Value: your_api_key_here

Key: limit
Value: 10

Ceux-ci seraient ajoutés à l'URL sous la forme ?apiKey=your_api_key_here&limit=10.

En-têtes

Configurez les en-têtes HTTP pour votre requête. Les en-têtes courants incluent :

Key: Content-Type
Value: application/json

Key: Authorization
Value: Bearer your_token_here

Corps de la requête

Pour les méthodes qui prennent en charge un corps de requête (POST, PUT, PATCH), vous pouvez définir les données à envoyer. Le corps peut être :

• Des données JSON saisies directement dans le bloc
• Des données connectées à partir de la sortie d'un autre bloc
• Générées dynamiquement pendant l'exécution du workflow

Accès aux résultats

Une fois qu'une requête API est terminée, vous pouvez accéder à ses sorties :

• <api.data> : Les données du corps de la réponse de l'API
• <api.status> : Code de statut HTTP (200, 404, 500, etc.)
• <api.headers> : En-têtes de réponse du serveur
• <api.error> : Détails de l'erreur si la requête a échoué

Fonctionnalités avancées

Construction dynamique d'URL

Construisez des URL dynamiquement en utilisant des variables provenant de blocs précédents :

// In a Function block before the API
const userId = <start.userId>;
const apiUrl = `https://api.example.com/users/${userId}/profile`;

Nouvelles tentatives de requête

Le bloc API gère automatiquement :

• Les délais d'attente réseau avec backoff exponentiel
• Les réponses de limite de débit (codes d'état 429)
• Les erreurs serveur (codes d'état 5xx) avec logique de nouvelle tentative
• Les échecs de connexion avec tentatives de reconnexion

Validation de la réponse

Validez les réponses API avant le traitement :

// In a Function block after the API
if (<api.status> === 200) {
  const data = <api.data>;
  // Process successful response
} else {
  // Handle error response
  console.error(`API Error: ${<api.status>}`);
}

Entrées et sorties

Exemples de cas d'utilisation

Récupérer les données de profil utilisateur

Traitement des paiements

Bonnes pratiques

• Utilisez des variables d'environnement pour les données sensibles : ne codez pas en dur les clés API ou les identifiants
• Gérez les erreurs avec élégance : connectez une logique de gestion des erreurs pour les requêtes échouées
• Validez les réponses : vérifiez les codes d'état et les formats de réponse avant de traiter les données
• Respectez les limites de taux : soyez attentif aux limites de taux des API et implémentez un throttling approprié