Aller au contenu principal

Déclencheur Interrogation

Le type Interrogation (Polling à l'écran) interroge périodiquement une API externe et lance le flux avec la réponse — ou les seuls éléments nouveaux, selon le mode choisi. Il convient lorsque le système cible n'envoie pas de webhooks : synchronisation, surveillance, intégration avec des APIs « pull only ».

Paramètres​

ParamètreTypeObligatoireDéfautDescription
SourceChaîne✅—Source de type API_POLLING.
URLURL✅—Point d'accès à interroger. Peut intégrer des variables de dictionnaire, par ex. https://{{dictionaries.partenaires.apiBaseUrl}}/orders.
Intervalle (secondes)Nombre✅—Valeur pollingIntervalInSeconds entre deux appels API.
Méthode HTTPGET / POST / PUT / DELETE / PATCH✅GETMéthode utilisée pour l'appel.
ModeNEW / ALL✅—NEW : ne traiter que les nouveaux éléments détectés ; ALL : traiter la réponse complète à chaque cycle.
Chemin d'extractionChaîne✅$extractionPath pour cibler les données utiles de la réponse.

Options avancées​

ParamètreTypeObligatoireDéfautDescription
HeadersPaires clé-valeur❌—En-têtes HTTP envoyés à l'API distante.

Entrée​

Le déclencheur interroge l'API configurée à chaque cycle et reçoit sa réponse. Le chemin d'extraction (extractionPath, défaut $) cible la portion de cette réponse à transmettre au flux.

Sortie​

Le flux reçoit la réponse de l'API, filtrée par le chemin d'extraction. Avec le mode NEW, seul l'écart détecté par rapport à l'exécution précédente déclenche le flux. Exemple de réponse transmise :

{
  "items": [
    { "orderId": "CMD-4821", "status": "new" },
    { "orderId": "CMD-4822", "status": "new" }
  ]
}

Erreurs​

  • Intervalle trop court — un polling trop fréquent surcharge l'API distante et épuise la source ; adaptez l'intervalle à la charge supportée par le système cible.
  • Échecs répétés — si l'API distante est indisponible, les exécutions échouent ; connectez un nœud On Error pour gérer les retentatives.

Limites​

  • L'intervalle doit respecter la charge supportée par le système distant : le polling appelle l'API à chaque cycle.
  • Si l'API est paginée, enchaînez les pages dans le flux ou adaptez l'URL entre deux cycles.
  • Pour de gros volumes, restreignez par plage de dates ou par identifiant « depuis la dernière exécution ».

Exemple​

Synchronisation des commandes : créez un déclencheur Interrogation sur l'URL de l'API (méthode GET, intervalle adapté, mode NEW), associez un flux qui traite les commandes retournées, puis déployez. Le polling démarre selon l'environnement et les traces montrent les éléments traités.

Voir aussi​