Consultez les connecteurs compatibles avec Application Integration.

Déclencheur d'API

Les déclencheurs d'API permettent d'appeler directement des exécutions pour des intégrations. Les déclencheurs d'API peuvent être utilisés en mode synchrone ou asynchrone.

Vous pouvez définir la charge utile de requête et de réponse pour le déclencheur d'API en créant des variables dans votre intégration. Pour savoir comment créer une intégration avec un déclencheur d'API qui reçoit des requêtes d'API pour récupérer des informations sur les clients, consultez le tutoriel sur l'exécution des API.

Ajouter un déclencheur d'API

Pour ajouter un déclencheur d'API, procédez comme suit :
  1. Dans la console Google Cloud, accédez à la page Application Integration.

    Accéder à Application Integration

  2. Dans le menu de navigation, cliquez sur Intégrations.

    La page Liste des intégrations s'affiche et liste toutes les intégrations disponibles dans le projet Google Cloud.

  3. Sélectionnez une intégration existante ou cliquez sur Créer une intégration pour en créer une.

    Si vous créez une intégration :

    1. Saisissez un nom et une description dans le volet Créer une intégration.
    2. Sélectionnez une région pour l'intégration.
    3. Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les informations du compte de service d'une intégration à tout moment dans le volet Récapitulatif de l'intégration de la barre d'outils d'intégration.
    4. Cliquez sur Créer.

    Cela entraîne son ouverture dans l'éditeur d'intégrations.

  4. Dans la barre de navigation de l'éditeur d'intégrations, cliquez sur Déclencheurs pour afficher la liste des déclencheurs disponibles.
  5. Cliquez sur l'élément Déclencheur d'API et placez-le dans le concepteur.

Configurer un déclencheur d'API

Cliquez sur l'élément Déclencheur d'API dans l'éditeur d'intégrations pour afficher le volet de configuration du déclencheur.

Le panneau de configuration affiche l'ID du déclencheur, qui est généré automatiquement au format api_trigger/TRIGGER_NAME. Aucune configuration supplémentaire n'est requise pour ce déclencheur.

Appeler un déclencheur d'API à partir d'une application

Après avoir publié une intégration dans laquelle un déclencheur d'API est configuré, vous pouvez utiliser la méthode projects.locations.integrations.execute pour appeler ce déclencheur à partir de n'importe quelle application. Cette méthode déclenche l'exécution en mode synchrone.

Syntaxe

curl -X POST \
    -H "authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{"trigger_id":"api_trigger/TRIGGER_NAME"}' \
    "https://LOCATION-integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-:execute"

Remplacez les éléments suivants :

  • TRIGGER_NAME : nom du déclencheur d'API de votre intégration.
  • PROJECT_ID : ID de votre projet Google Cloud.
  • LOCATION: emplacement de votre projet Google Cloud.

Exemple

L'exemple suivant appelle une intégration dans la région us-east1 contenant le déclencheur d'API test_API_1 dans le projet Google Cloud demo-project:

curl -X POST \
    -H "authorization: Bearer $(gcloud auth print-access-token)"
    -H "Content-Type: application/json" \
    -d '{"trigger_id":"api_trigger/test_API_1"}' \
    "https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-central1/integrations/-:execute"

Remarques

Lorsque vous utilisez le déclencheur d'API, la taille cumulée de toutes les variables d'entrée peut être de 8 Mo au maximum. Si la taille dépasse 8 Mo, l'intégration d'applications n'exécute pas l'intégration et vous obtenez une erreur.

Quotas et limites

Pour plus d'informations sur les quotas et les limites, consultez la section Quotas et limites.

Étape suivante