Méthodes de requête HTTP

Dernière mise à jour : 16 janvier 2025
  • Rubriques :

Lorsque vous configurez un appel API dans un module, vous devez sélectionner la méthode de requête HTTP. Cet article décrit les méthodes disponibles et les raisons de leur sélection.

Méthodes HTTP

Utilisez l’une des méthodes HTTP suivantes.

  • GET : récupère les données d’un serveur web en fonction de vos paramètres. GET demande une représentation de la ressource spécifiée et reçoit un message de réponse 200 OK avec le contenu demandé en cas de réussite.
  • POST : envoie les données à un serveur web en fonction de vos paramètres. Les requêtes POST incluent des actions telles que le chargement d’un fichier. L’envoi de plusieurs POST peut avoir un résultat différent de celui d’un seul POST. Par conséquent, faites attention à ne pas envoyer involontairement plusieurs POST. Si une POST réussit, vous recevez un message de réponse 200 OK.
  • PUT : envoie les données à un emplacement du serveur web en fonction de vos paramètres. Les requêtes PUT incluent des actions telles que le chargement d’un fichier. La différence entre un PUT et un POST réside dans le fait que le PUT est idempotent, ce qui signifie que le résultat d’un seul PUT réussi est le même que celui de nombreux PUT identiques. Si un PUT réussit, vous recevez un message de réponse 200 (généralement 201 ou 204).
  • PATCH : (non disponible pour certains modules d’appel API) applique des modifications partielles à une ressource sur un serveur web en fonction de vos paramètres. PATCH n’est pas idempotent, ce qui signifie que le résultat de plusieurs PATCH peut avoir des conséquences inattendues. Si une PATCH réussit, vous recevrez un message de réponse 200 (généralement 204).
  • DELETE : supprime la ressource spécifiée du serveur web en fonction de vos paramètres (si la ressource existe). Si une DELETE réussit, vous recevez un message de réponse 200 OK.
Page précédenteModules itérateurs
Page suivanteClés

Workfront