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. Note : Pour la base de données Oracle, lors du renvoi du contenu complet de la réponse au paramètre OUTAPP_RESPONSE_CONTENTou du mappage d'une valeur du contenu de la réponse vers un paramètre OUT de type text, la longueur est toujours limitée à 4 000 caractères en raison d'une limitation de type de données utilisé dans Oracle. Dans ce cas, le paramètre de configuration SendHttpPostMaxResponseLength n'est pas applicable à Oracle.

• 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ètre	Type	Direction	Description
APP_URL	Text	IN	URL de l’API externe

Paramètres facultatifs

Paramètre	Type	Direction	Description
TOKEN	Text	IN	Jeton d’autorisation de l’API
APP_TIMEOUT	Numeric	IN	L’intervalle maximum entre l’expédition de la requête et la réception de la réponse (par défaut : 3000 millisecondes; maximum : 60 000 millisecondes)
APP_CONTENT_TYPE	Text	IN	Type du contenu de la requête (JSON et URLENCODED sont supportés; le type par défaut est JSON)
APP_RESPONSE_CONTENT	Text	OUT	Charge utile ou message d’erreur facultatif retournée
APP_RESPONSE_STATUS	Text/Numeric	OUT	Code retourné du statut de la requête HTTP
APP_HEADER_xxx	Text	IN	Paramètres d'en-tête d'API externe dans lesquels xxx est le nom du champ d'en-tête
APP_REQUEST_CONTENT_IS_ARRAY	Text	IN	Lorsque ce paramètre est défini sur Y, l'application convertit la charge utile de la demande JSON en un tableau. La valeur par défaut est N.
			Seulement pris en charge lors de la construction d'une charge de requête JSON avec des paramètres IN.

Exemples

Paramètre	Type	Direction	Valeur
APP_HEADER_Authorization	Text	IN	Bearer AbCdEf123456
APP_HEADER_location	Text	IN	canadaeast

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"
    }
}]