7.22
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ètreAPP_URL, les deux valeurs devraient être concaténées dans le paramètreAPP_URL, laissant ainsi vide le paramètreTOKEN. - 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_STATUSn’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_emojide 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 lesquelsxxxest 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
SendHttpPostMaxResponseLengthdans le fichierweb.config. - Des logs d’application sont disponibles; ceux-ci peuvent être configurés en réglant la valeur du paramètre
SendHttpPostLogLeveldans le fichierweb.configà0pour désactiver la journalisation, à1pour des logs simples ou à2pour des logs de débogage.
Paramètres
Paramètre obligatoire
Paramètre
Type
Direction
Description
APP_URLText
IN
URL de l’API externe
Paramètres facultatifs
Paramètre
Type
Direction
Description
TOKENText
IN
Jeton d’autorisation de l’API
APP_TIMEOUTNumeric
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_TYPEText
IN
Type du contenu de la requête (JSON et URLENCODED sont supportés; le type par défaut est JSON)
APP_RESPONSE_CONTENTText
OUT
Charge utile ou message d’erreur facultatif retournée
APP_RESPONSE_STATUSText/Numeric
OUT
Code retourné du statut de la requête HTTP
APP_HEADER_xxxText
IN
Paramètres d'en-tête d'API externe dans lesquels
xxx est le nom du champ d'en-têteAPP_REQUEST_CONTENT_IS_ARRAYText
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_AuthorizationText
IN
Bearer AbCdEf123456APP_HEADER_locationText
IN
canadaeastLes paramètres définis ci-dessus généreront deux en-têtes dans la charge de la requête :
1
Authorization: Bearer AbCdEf123456
2
location: canadaeast
Copied!
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 :1
[{
2
"person": {
3
"address": {
4
"street": "160 Guy Street",
5
"zipcode": "J4G 1U4"
6
},
7
"age": 30,
8
"name": "John"
9
}
10
}
Copied!
Dernière mise à jour 1yr ago