Activité de requête HTTP

Vue d'ensemble (Overview)

L’activité Demande HTTP (HTTP Request) vous permet d’effectuer des requêtes HTTP vers une API spécifiée en utilisant le connecteur et la configuration de connexion existants.

Pourquoi choisir l’activité Demande HTTP (HTTP Request) plutôt que d’autres activités pour un connecteur ?

Grâce à l’activité Demande HTTP (HTTP Request), vous pouvez effectuer des demandes sur n’importe quel point de terminaison de l’API d’un fournisseur, de façon à accéder à l’ensemble de ses fonctionnalités. Cela signifie que vous ne serez plus limité aux fonctionnalités des activités prédéfinies proposées par le connecteur Integration Service.

Remarque : l’activité Demande HTTP (HTTP Request) est désormais disponible seulement pour une partie des connecteurs Integration Service. Elle sera bientôt étendue à tous les autres connecteurs prenant en charge le format JSON. Consultez les notes de publication de chaque package d’activités pour savoir si l’activité est activée pour tel ou tel connecteur. Elle est également disponible par défaut pour tout connecteur personnalisé créé via le générateur de connecteurs.

Limitations

• Les connecteurs basés sur des API SOAP ou des SDK ne prennent pas en charge cette activité.
• Les actions de téléchargement ou de chargement de fichier ne sont actuellement pas prises en charge.
• Cette activité n’accepte actuellement que application/json comme type de contenu.

Compatibilité du projet

Les activités Demande HTTP sont disponibles dans Studio Web et dans les projets Windows et multiplate-formes Studio Desktop.

Configuration

• ID de connexion : la connexion établie dans Integration Service. Accédez au menu déroulant pour choisir, ajouter ou gérer des connexions. Cette connexion est la même que pour toutes les autres activités sur ce connecteur
• Méthode : la méthode de requête à utiliser lors de l’appel de l’API. Les verbes HTTP suivants sont pris en charge :
  • GET - Méthode utilisée pour demander des données à partir d'une ressource spécifiée.
  • DELETE : la méthode utilisée pour supprimer des données à partir d’une ressource spécifiée.
  • PATCH - Méthode utilisée pour appliquer des modifications partielles à une ressource.
  • POST - Méthode utilisée pour envoyer des données au serveur.
  • PUT - Méthode utilisée pour envoyer des données au serveur pour mettre à jour une ressource.
• URL de base : indique l’URL de base de la demande. Ce champ est en lecture seule et fourni par le connecteur. Si votre point de terminaison nécessite une URL ou un chemin de base différent, il s’agit probablement d’une demande de modification ou d’une demande HTTP personnalisée effectuée via le package d’activités Web.
• Point de terminaison : indique le chemin du point de terminaison de la demande. Ce champ sera concaténé en lecture seule au champ URL de base.
• En-têtes : les en-têtes de la demande. Utilisez l’éditeur de dictionnaire pour ajouter des en-têtes. Les en-têtes par défaut envoyés par le connecteur au fournisseur s’affichent déjà dans la zone d’informations. Ce champ de dictionnaire d’en-têtes vous permet d’ajouter d’autres en-têtes.
• Paramètres de requête : les paramètres de la requête. Utilisez l’éditeur de dictionnaire pour ajouter de nouveaux paramètres.
  • Exemple : query value "select * from Vendor" (pour QuickBooks Online).
• Corps : saisissez une charge utile JSON qui sera envoyée au point de terminaison fourni.

Propriétés supplémentaires

Sortie

• Contenu de la réponse : la réponse reçue de la requête HTTP. Il s’agit d’un fichier JSON qui peut être désérialisé.
• Statut de la réponse : Code d'état reçu de la requête HTTP, en tant que variable entière.
• En-têtes de réponse : la réponse reçue de la requête HTTP.