|
Les types de fichiers classiques ne pourront plus être utilisés à partir de janvier 2021. Vous pouvez transférer vos fichiers classiques ou télécharger un PDF. En savoir plus

Portail de support Workiva

Commandes de requêtes HTTP

Commandes de requêtes HTTP

  • Dernière mise à jour le

Une connexion HTTP Requests exécute ces commandes pour effectuer des requêtes HTTP (HyperText Transfer Protocol) à une URL donnée afin de se connecter et d'automatiser les solutions prises en charge par l'intermédiaire de leurs connecteurs respectifs.

Pour voir comment une requête HTTP est structurée, consultez notre liste d'exemples HTTP Connector.

Note : Bien qu’il s’agisse d’une requête HTTP, le protocole HTTPS (Secure HTTP) est pris en charge (et recommandé).

Exigences

  • Bien que la connexion n'ait pas de caractéristiques spécifiques à OData, vous pouvez ajouter tous les composants nécessaires à la requête via les paramètres Headers ou Query string.
  • Pour activer l'authentification mutuelle TLS (mTLS), fournissez une paire de clés publique/privée et, éventuellement, un certificat CA. Pour utiliser les clés publiques et privées, les télécharge en tant que ressources de l'espace de travail, puis les sélectionne respectivement pour les paramètres Certificate et Certificate private key de la commande.
  • Le fichier contenant la clé privée ne doit pas être crypté. Le chargement d’un fichier crypté en tant que clé privée entraîne une erreur.

Pour activer ces commandes, un administrateur informatique crée d'abord un connecteur de requête HTTP.

Supprimer

Pour supprimer une ressource, utilisez la commande Delete. Cette commande émet une requête HTTP DELETE, telle que http://postman-echo.com/delete.

Propriétés

Propriété Détail
Nom d’utilisateur Si l'authentification de base est requise, saisissez le nom d'utilisateur.
Mot de passe Si l'authentification de base est requise, saisissez le mot de passe.
certificat d’autorité de certification Saisissez le certificat de l'autorité de certification (CA) à utiliser lors de la demande (facultatif).
Certificat Saisissez le certificat à envoyer avec la demande (facultatif). S'il est fourni, entrez également Clé privée du certificat.
Clé privée du certificat Saisissez la clé privée du certificat , si elle a été fournie.
Afficher la réponse Pour afficher le corps de la réponse de l'API dans la sortie, cochez cette case.
URL Saisissez l'URL utilisée pour la demande, par exemple http://postman-echo.com/delete.
Type de contenu Saisissez l'en-tête content-type à définir. Ceci spécifie le format attendu pour le corps de la demande.
Fichier corporel Entrez le fichier qui contient l'objet JSON ou les paramètres de la demande à envoyer dans le corps de la demande. Si vous l'incluez, laissez Body text vide.
Corps du texte Saisissez le texte à envoyer dans le corps de la demande. Si vous l'incluez, laissez le fichier Body vide.
En-têtes Saisissez tout en-tête supplémentaire à ajouter à la demande.

Sorties

Sortie Type de sortie
En-têtes de réponse JSON
Réponse Fichier
Code de réponse Entier

Codes de sortie

Code Type Détail
0 Réussite Réussite
2 Erreur Échec de la demande ; code de réponse non-200
4 Erreur Certificat non trouvé
5 Erreur En-têtes de requête non valides

Obtenir

Pour récupérer une ressource, utilisez la commande Get. Cette commande lance une requête HTTP GET, telle que https://postman-echo.com/get?foo1=bar1&foo2=bar2.

Note : Cette commande comprend un espace pour entrer les paramètres de la requête -- les paramètres ne doivent pas être inclus dans l'URL elle-même. Si des paramètres sont saisis à la fois dans l'URL et dans le champ "Query string", ils seront supprimés de l'URL.

Propriétés

Propriété Détail
Nom d’utilisateur Si l'authentification de base est requise, saisissez le nom d'utilisateur.
Mot de passe Si l'authentification de base est requise, saisissez le mot de passe.
certificat d’autorité de certification Saisissez le certificat CA à utiliser lors de la demande (facultatif).
Certificat Saisissez le certificat à envoyer avec la demande (facultatif). S'il est fourni, entrez également Clé privée du certificat.
Clé privée du certificat Saisissez la clé privée du certificat , si elle a été fournie.
Afficher la réponse Pour afficher le corps de la réponse de l'API dans la sortie, cochez cette case.
URL Saisissez l'URL utilisée pour la demande, par exemple https://postman-echo.com/get.
Chaîne de requête

Saisissez la chaîne de requête à ajouter à la demande, par exemple foo1=bar1&foo2=bar2.

Note : La chaîne de requête doit être codée.
En-têtes Saisissez tout en-tête supplémentaire à ajouter à la demande.
Type de contenu Saisissez l'en-tête content-type à définir, par exemple application/json. Ceci spécifie le format attendu pour le corps de la demande.
Schéma de sortie Pour permettre aux commandes suivantes de la chaîne d'accéder aux propriétés de sortie de cette commande, saisissez un échantillon de données utiles pour chaque sortie JSON. 

Sorties

Sortie Type de sortie
En-têtes de réponse JSON
Réponse Fichier
Code de réponse Entier

Codes de sortie

Code Type Détail
0 Réussite Réussite
2 Erreur Échec de la demande ; code de réponse non-200
4 Erreur Certificat non trouvé
5 Erreur En-têtes de requête non valides

Publier

Pour placer une ressource, utilisez la commande Post. Cette commande lance une requête HTTP POST, telle que https://postman-echo.com/post.

Propriétés

Propriété Détail
Nom d’utilisateur Si l'authentification de base est requise, saisissez le nom d'utilisateur.
Mot de passe Si l'authentification de base est requise, saisissez le mot de passe.
certificat d’autorité de certification Saisissez le certificat CA à utiliser lors de la demande (facultatif).
Certificat Saisissez le certificat à envoyer avec la demande (facultatif). S'il est fourni, entrez également Clé privée du certificat.
Clé privée du certificat Saisissez la clé privée du certificat , si elle a été fournie.
Afficher la réponse Pour afficher le corps de la réponse de l'API dans la sortie, cochez cette case.
URL Saisissez l'URL utilisée pour la demande, par exemple https://postman-echo.com/post.
Type de contenu

Saisissez l'en-tête content-type à définir. Ceci spécifie le format attendu pour le corps de la demande.

Note : Pour les données en plusieurs parties, ajouter Les valeurs du formulaire sont utilisées pour générer le corps.
Fichier corporel Entrez le fichier qui contient l'objet JSON ou les paramètres de la demande à envoyer dans le corps de la demande. Si vous l'incluez, laissez Body text vide.
Corps du texte

Saisissez le texte à envoyer dans le corps de la demande. Si vous l'incluez, laissez le fichier Body vide.
Conseil : s’il y a des paramètres à sélection multiple, utilisez le modèle suivant :

{ "queryId": "YOUR_QUERY_ID", "parameters": { "yourParamName": ["value1", "value2"] } }
En-têtes Saisissez tout en-tête supplémentaire à ajouter à la demande.
Valeurs du formulaire Pour générer le corps des données en plusieurs parties, ajoutez les valeurs du formulaire à inclure dans la demande et saisissez le nom et la valeur de chacune d'entre elles. Si vous ajoutez des valeurs de formulaire, laissez Content type vide.
Schéma de sortie Pour permettre aux commandes suivantes de la chaîne d'accéder aux propriétés de sortie de cette commande, saisissez un échantillon de données utiles pour chaque sortie JSON. 

Sorties

Sortie Type de sortie
En-têtes de réponse JSON
Réponse Fichier
Code de réponse Entier

Codes de sortie

Code Type Détail
0 Réussite Réussite
2 Erreur Échec de la demande ; code de réponse non-200
4 Erreur Certificat non trouvé
5 Erreur En-têtes de requête non valides

Mettre

Pour modifier ou mettre à jour une ressource, utilisez la commande Put. Cette commande lance une requête HTTP PUT, telle que https://postman-echo.com/put.

Propriétés

Propriété Détail
Nom d’utilisateur Si l'authentification de base est requise, saisissez le nom d'utilisateur.
Mot de passe Si l'authentification de base est requise, saisissez le mot de passe.
certificat d’autorité de certification Saisissez le certificat CA à utiliser lors de la demande (facultatif).
Certificat Saisissez le certificat à envoyer avec la demande (facultatif). S'il est fourni, entrez également Clé privée du certificat.
Clé privée du certificat Saisissez la clé privée du certificat , si elle a été fournie.
Afficher la réponse Pour afficher le corps de la réponse de l'API dans la sortie, cochez cette case.
URL Saisissez l'URL utilisée pour la demande.
Type de contenu

Saisissez l'en-tête content-type à définir. Ceci spécifie le format attendu pour le corps de la demande.

Note : Pour les données en plusieurs parties, ajouter Les valeurs du formulaire sont utilisées pour générer le corps.
Fichier corporel Entrez le fichier qui contient l'objet JSON ou les paramètres de la demande à envoyer dans le corps de la demande. Si vous l'incluez, laissez Body text vide.
Corps du texte Saisissez le texte à envoyer dans le corps de la demande. Si vous l'incluez, laissez le fichier Body vide.
En-têtes Saisissez tout en-tête supplémentaire à ajouter à la demande.
Valeurs du formulaire Pour générer le corps des données en plusieurs parties, ajoutez les valeurs du formulaire à inclure dans la demande et saisissez le nom et la valeur de chacune d'entre elles. Si vous ajoutez des valeurs de formulaire, laissez Content type vide.
Schéma de sortie Pour permettre aux commandes suivantes de la chaîne d'accéder aux propriétés de sortie de cette commande, saisissez un échantillon de données utiles pour chaque sortie JSON.

Sorties

Sortie Type de sortie
En-têtes de réponse JSON
Réponse Fichier
Code de réponse Entier

Codes de sortie

Code Type Détail
0 Réussite Réussite
2 Erreur Échec de la demande ; code de réponse non-200
4 Erreur Certificat non trouvé
5 Erreur En-têtes de requête non valides
Une connexion HTTP Requests exécute ces commandes pour effectuer des requêtes HTTP (HyperText Transfer Protocol) à un...