Consultez la liste des 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 en savoir plus sur la création d'une intégration avec un déclencheur d'API qui reçoit des requêtes API pour récupérer des informations client, consultez le tutoriel Traitement de l'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 Integrations (Intégrations).

    La page Liste des intégrations s'affiche. Elle répertorie 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 détails du compte de service d'une intégration à tout moment depuis le volet Résumé de l'intégration de dans la barre d'outils d'intégration.
    4. Cliquez sur Créer.

    La page de l'éditeur d'intégration s'affiche.

  4. Dans la barre de navigation de l'éditeur d'intégration, 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 pour laquelle un déclencheur d'API est configuré, vous pouvez l'appeler à partir de n'importe quelle application à l'aide de la méthode projects.locations.integrations.execute. 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://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-:execute"

Remplacez les éléments suivants :

  • TRIGGER_NAME: nom du déclencheur d'API dans 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, Application Integration n'exécute pas l'intégration et génère une erreur.