Présentation de REST

De Appmethod Topics
Aller à : navigation, rechercher

Remonter à Développement d'applications EMS, Cloud et REST


REST est l'acronyme de Representational State Transfer. Il repose sur une architecture client-serveur et permet de concevoir des applications réseau en utilisant le protocole HTTP pour les appels entre les machines.

La conformité aux contraintes REST est référencée comme étant RESTful. Un service web RESTful est implémenté en utilisant HTTP (HyperText Transfer Protocol) et les principes de REST.

Présentation de REST

Le protocole REST suppose que le serveur est capable de répondre à quatre types de requêtes : GET, POST, PUT et DELETE. Ces opérations représentent les opérations de données Récupérer, Mettre à jour, Insérer et Supprimer. Elles sont assimilées aux méthodes serveur via un protocole de mappage. REST suppose que chaque méthode serveur peut être invoquée sous la forme d'une des opérations citées ci-dessus, via un mécanisme de répartition qui suppose un mappage entre le chemin de l'URI (Uniform Resource Identifier), la ressource et les paramètres.

L'interface entre les serveurs et les clients simplifie l'architecture ; ainsi, chaque partie peut évoluer indépendamment.

Basé sur les ressources

REST ne peut fonctionner sans les ressources. Une ressource est une source d'information référencée par une adresse URI. Le serveur renvoie des représentations des informations au client (HTML, XML, JSON).

Les ressources peuvent être manipulées par le biais des représentations, ce qui permet de les modifier ou de les supprimer sur le serveur.

Mappage des URI

Le serveur répond aux URI. Chaque ressource sur le serveur a sa propre adresse ou son URI.

La requête HTTP générale a le format suivant :

http://my.site.com/resource/items

Méthodes HTTP

Les méthodes HTTP les plus couramment utilisées pour interagir avec les ressources sur le serveur sont les suivantes :

Type de commande Description Exemple Code de réponse HTTP

GET

La méthode HTTP GET est utilisée pour lire ou extraire une représentation d'une ressource.
Get renvoie une représentation au format XML ou JSON.

GET http://my.site.com/users/123

  • Aucune erreur :
    • OK : code 200
  • Erreurs :
    • Requête incorrecte : code 400
    • Introuvable : code 404

PUT

La méthode HTTP PUT est le plus souvent utilisée pour mettre à jour les informations.

PUT http://my.site.com/users/123

  • Aucune erreur :
    • OK : code 200
    • Pas de contenu : code 204
  • Erreurs :
    • Introuvable : code 404

POST

La méthode HTTP POST est le plus souvent utilisée pour créer une nouvelle ressource.

POST http://my.site.com/devices
POST http://my.site.com/users/123/orders

  • Aucune erreur :
    • Créée : code 201
  • Erreurs :
    • Introuvable : code 404

DELETE

La méthode HTTP DELETE est utilisée pour supprimer une ressource identifiée par un URI.

DELETE http://my.site.com/users/123/orders

  • Aucune erreur :
    • OK : code 200
    • Pas de contenu : code 204
  • Erreurs :
    • Introuvable : code 404

Voir aussi