Méthodes HTTP

De Centre Documentation PowerBoutique
Aller à : navigation, rechercher

L'API utilise les différentes méthodes HTTP standard pour déterminer les opérations à réalisées sur les ressources.

GET

Définition: C'est la méthode la plus courante pour demander une ressource. Une requête GET est sans effet sur la ressource, il doit être possible de répéter la requête sans effet.

Usage: utilisé pour les lectures et les recherches / listings.

HEAD

Définition: Cette méthode ne demande que des informations sur la ressource, sans demander la ressource elle-même.

Usage: pas utilisé.

POST

Définition: Cette méthode doit être utilisée pour soumettre des données en vue d'un traitement à une ressource (typiquement depuis un formulaire HTML). L'URI fournie est l'URI d'une ressource à laquelle s'appliqueront les données envoyées. Le résultat peut être la création de nouvelles ressources ou la modification de ressources existantes. À cause de la mauvaise implémentation des méthodes HTTP (pour Ajax) par certains navigateurs (et la norme HTML qui ne supporte que les méthodes GET et POST pour les formulaires), cette méthode est souvent utilisée en remplacement de la requête PUT, qui devrait être utilisée pour la mise à jour de ressources.

Usage: utilisé pour modifier une ressource.

OPTIONS

Définition: Cette méthode permet d'obtenir les options de communication d'une ressource ou du serveur en général.

Usage: liste les méthodes valides sur une ressource.

CONNECT

Définition: Cette méthode permet d'utiliser un proxy comme un tunnel de communication.

Usage: pas utilisé.

TRACE

Définition: Cette méthode demande au serveur de retourner ce qu'il a reçu, dans le but de tester et effectuer un diagnostic sur la connexion.

Usage: pas utilisé.

PUT

Définition: Cette méthode permet de remplacer ou d'ajouter une ressource sur le serveur. L'URI fourni est celui de la ressource en question.

Usage: création d'une nouvelle ressource.

DELETE

Définition: Cette méthode permet de supprimer une ressource du serveur.

Usage: suppression d'un élement.