Méthodes de requête HTTP

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 succès.
  • POST : envoie des données à un serveur web en fonction de vos paramètres. Les requêtes POST comprennent des actions telles que le chargement d’un fichier. Plusieurs POSTs peuvent avoir un résultat différent d’un seul POST. Soyez donc prudent en cas d’envoi involontaire de plusieurs POST. Si une opération POST réussit, vous recevez un message de réponse 200 OK.
  • PUT : envoie des données à un emplacement du serveur web en fonction de vos paramètres. Les requêtes PUT comprennent des actions telles que le chargement d’un fichier. La différence entre un PUT et un POST est que PUT est idempotent, ce qui signifie que le résultat d’un seul PUT réussi est le même que de nombreux PUT identiques. Si un PUT est réussi, 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 requêtes PATCH pourrait avoir des conséquences inattendues. Si une requête 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 requête DELETE réussit, vous recevez un message de réponse 200 OK.
recommendation-more-help
workfront-fusion-help-workfront-fusion