Aller au contenu principal

Appel REST Authentifié

Configuration actuelle de la tâche Appel REST authentifié dans le concepteur de flux de travail

La tâche Appel REST Authentifié effectue une requête HTTP vers un service externe. Elle prend en charge les requêtes anonymes, l'authentification Basic ou Bearer, les en-têtes personnalisés, le corps de la requête et le proxy.

Configuration

ChampDescription
Connexion SSLIndique si utiliser une connexion protégée.
ProxyUtilise la configuration système, aucun proxy ou un proxy personnalisé.
Adresse proxyObligatoire uniquement en choisissant un proxy personnalisé.
URLAdresse du service. Peut contenir des paramètres de workflow dynamiques.
AuthentificationAucune, Basic ou Bearer.
Utilisateur et Mot de passeCoordonnées requises pour l'authentification Basic.
TokenCoordonnée requise pour l'authentification Bearer.
MéthodeGET, POST ou PUT.
En-têtesListe JSON des en-têtes à envoyer.
CorpsCorps de la requête ; non prévu pour la méthode GET.

Les en-têtes sont représentés sous forme de liste de chaînes :

[
"Content-Type: application/json",
"Accept-Language: it-IT"
]

Dans le corps, vous pouvez utiliser les paramètres Sybot. Dans cet exemple, les valeurs proviennent de tâches précédentes :

string:{
"documento": "#>document_name<#",
"stato": "#>document_status<#"
}

N'insérez pas de coordonnées directement dans les en-têtes ou le corps lorsque les champs d'authentification appropriés sont disponibles. Évitez également de reporter des mots de passe, des jetons ou du contenu confidentiel dans les noms des tâches et les messages destinés aux journaux.

Résultats

La tâche rend disponibles :

  • les en-têtes et le corps de la réponse ;
  • le code de statut HTTP ;
  • le résultat de l'opération ;
  • le résumé structuré de l'exécution.

Utilisez le code HTTP et le contenu de la réponse dans les conditions suivantes. Un code 2xx indique normalement une requête acceptée, tandis que les codes 4xx et 5xx nécessitent la gestion de l'erreur prévue par le workflow.

Vérification

Exécutez initialement l'appel avec des données synthétiques et vérifiez dans Logs méthode, code de réponse et éventuel message de diagnostic. Les données sensibles ne doivent pas être copiées dans des variables destinées aux notifications ou aux fichiers publics.