Remarque :  Cet article s’applique à l’intégration des actions données sur les Web.

Lorsque vous données sur les services Web ajoutez l’intégration des actions, vous pouvez sélectionner un type d’identification : Auth de base, utilisateur défini ou défini par l’utilisateur (OAuth). Pour plus d’informations, voir Ajouter une intégration d’actions de données et Types d’informations d’identification.

Cet article explique comment utiliser le type d’informations d’identification défini par l’utilisateur. 

  1. Lorsque vous ajoutez l’intégration, configurez les informations d’identification définies par l’utilisateur.

    Ajoutez des noms de champs pour l’API que vous utilisez et des valeurs pour ces noms de champs.

    Configurer les informations d’identification pour l’utilisateur

  2. Utilisez les noms de champ de vos informations d’identification dans les demandes de toutes les actions personnalisées que vous créez. 

    L’exemple suivant est une demande d’action personnalisée appelée Get Weather. références est un mot clé statique, que vous pouvez utiliser avec d’autres macros Velocity. Clé API est le nom de champ que vous avez ajouté à la configuration des informations d’identification. Pour plus d’informations, voir Macros Velocity pour les actions de données.

    Bien que l’intégration résoutles les valeurs des noms de champ, les valeurs réelles apparaissent dans votre service Web. Par exemple, si la valeur API-Key (en anglais seulement) est 12345, puis lorsque l’action s’exécute, la demandeUrlTemplate que vous voyez dans votre service web est "https :///données/2.5/météo ?q-London-APPID-12345". Pour plus d’informations, voir Créer une action personnalisée, Ajouter la configuration aux actions personnaliséeset Configuration de la demande.

    Avertissement : Assurez-vous d’échapper à toute utilisation des variables d’entrée ou de sortie dans requestTemplate, successTemplate, ou requestUrlTemplate. Si vous n’échappez pas correctement les variables avec des caractères spéciaux, vos actions sur les données échoueront à l’exécution.
    • Utilisation esc.jsonString pour échapper aux chaînes à l’intérieur des corps JSON.

      Pour plus d’informations sur l’échappement, consultez le esc.jsonString section à Macros de vitesse pour les actions de données.

    • Utilisation esc.url () ou urlTool.optionalQueryParam () pour échapper correctement les paramètres de chemin ou de requête pour un requestUrlTemplate ou requestTemplate si vous utilisez x-www.form-urlencoded valeurs.

      Pour plus d’informations, consultez la section bibliothèque échappement de chaîne à l’bibliothèque Macros de vitesse.

    Étant donné que l’échappement est spécifique au contexte JSON, l’exemple suivant n’affiche pas intentionnellement l’échappement.

    {
      "requestUrlTemplate": "https://api.openweathermap.org/data/2.5/weather?q=London&APPID=${credentials.API_Key}",
      "requestType": "GET",
      "headers": {},
      "requestTemplate": "${input.rawRequest}"
    }
    Remarque :  Lorsque vous testez une action personnalisée, l’intégration résout toute information d’autorisation. Pour plus d’informations, voir Testez une action personnalisée.

Pour plus d’informations sur l’intégration, voir A propos de l’intégration des actions données sur les s Web.