Application de workflow SENDHTTPPOST

Aperçu

L’application de workflow SENDHTTPPOST permet d’envoyer des requêtes HTTP « webhook » à des systèmes externes. Les webhooks permettent à une API d’échanger des informations avec d’autres applications via des requêtes HTTP POST et peuvent être utilisés pour créer des intégrations avec des applications extensibles telles que Slack, GitHub et Dropbox. Par exemple, les webhooks peuvent être utilisés pour des notifications quand un événement prévu (configuré par l’utilisateur) soit survenu. En permettant une communication en temps réel, les webhooks sont efficaces et performants.

SENDHTTPPOST envoie des webhooks sortants à des applications externes en utilisant des charges utiles (« payloads ») JSON ou URLENCODED. Ensuite, SENDHTTPPOST reçoit et traite la réponse de l’API externe. Pour plus d’informations, voir l’article Using webhooks with WorkflowGen.

Pour un exemple d’utilisation de SENDHTTPPOST pour envoyer des messages depuis WorkflowGen à des canaux Slack, voir l’article Workflow Application: Using SENDHTTPPOST to send messages to Slack. Des exemples d’API qui utilisent SENDHTTPPOST sont également disponibles dans le répertoire GitHub SENDHTTPPOST Workflow Application.

Mode de fonctionnement

  • Le type de charge utile (« payload ») par défaut (APP_CONTENT_TYPE) est JSON; URLENCODED est également supporté.

  • Étant donné que les paramètres de l’application sont sensibles à la casse, ils doivent respecter la notation acceptée de l’API.

  • L’application SENDHTTPPOST requiert le paramètre APP_URL, qui correspond à l’URL de l’API externe.

  • Le paramètre TOKEN (jeton) est disponible pour usage dans l’authentification API. Quand une API récupère la valeur du jeton dans le paramètre APP_URL, les deux valeurs devraient être concaténées dans le paramètre APP_URL, laissant ainsi vide le paramètre TOKEN.

  • La réponse peut contenir une charge utile facultative correspondante à des paramètres OUT définis par les utilisateurs.

  • En cas d’erreur quand le paramètre OUT APP_RESPONSE_STATUS n’est pas défini, une exception sera lancée.

  • Le formulaire doit contenir des champs textbox pour tous les paramètres utilisés, avec les données des champs correspondants aux paramètres SENDHTTPPOST.

  • Outre les paramètres facultatifs listés ci-dessous, vous pouvez également ajouter des paramètres IN et OUT personnalisés (spécifiques à l'API externe) pour envoyer et recevoir des données personnalisées définies par l'utilisateur vers et depuis l'API externe. Par exemple, dans une intégration Slack, vous pouvez ajouter un paramètre pour inclure un emoji dans un message Slack et le mapper au paramètre icon_emoji de Slack (il s'agit de la notation acceptée par l'API Slack pour ce paramètre particulier).

  • Le délai d’expiration (APP_TIMEOUT) par défaut est de 3000 millisecondes; le délai d’expiration maximum est de 60 000 millisecondes.

  • Les en-têtes de requête HTTP peuvent être définis avec les paramètres APP_HEADER_xxx, dans lesquels xxx est le nom du champ d'en-tête.

  • La longueur de réponse maximale par défaut est de 4194304 caractères (4 Mo); cette valeur par défaut peut être modifiée en définissant la valeur du paramètre SendHttpPostMaxResponseLength dans le fichier web.config.

  • Des logs d’application sont disponibles; ceux-ci peuvent être configurés en réglant la valeur du paramètre SendHttpPostLogLevel dans le fichier web.config à 0 pour désactiver la journalisation, à 1 pour des logs simples ou à 2 pour des logs de débogage.

Paramètres

Paramètre obligatoire

Paramètres facultatifs

Exemples

Les paramètres définis ci-dessus généreront deux en-têtes dans la charge de la requête :

Authorization: Bearer AbCdEf123456
location: canadaeast

Convertir la charge de la requête JSON en un tableau

Lorsque vous définissez le paramètre APP_REQUEST_CONTENT_IS_ARRAY sur Y, il convertira le JSON en un tableau :

[{
    "person": {
        "address": {
            "street": "160 Guy Street",
            "zipcode": "J4G 1U4"
        },
        "age": 30,
        "name": "John"
    }
}

Dernière mise à jour