Plan du cours
HTTP
- Le protocole HTTP
- Les cas d'utilisation
- La négociation de contenu
- Les requêtes conditionnelles
- La gestion du cache
- Les liens
REST & API Web
Annexes
Introduction : Web Service et Web API
Le terme de Web service est problématique car, pour des raisons historiques, il peut regrouper plusieurs acceptions. Voici la définition du terme "Web service" donnée respectivement par le W3C et Wikipedia :
There are many things that might be called "Web services" in the world at large. However, for the purpose of this Working Group and this architecture, and without prejudice toward other definitions, we will use the following definition:
A Web service is a software system designed to support interoperable machine-to-machine interaction over a network. It has an interface described in a machine-processable format (specifically WSDL). Other systems interact with the Web service in a manner prescribed by its description using SOAP-messages, typically conveyed using HTTP with an XML serialization in conjunction with other Web-related standards.
A Web service is a service offered by an electronic device to another electronic device, communicating with each other via the World Wide Web. In a Web service, Web technology such as HTTP, originally designed for human-to-machine communication, is utilized for machine-to-machine communication, more specifically for transferring machine readable file formats such as XML and JSON.
La définition du W3C restreint la notion de service Web à un ensemble de technologies (WSDL, SOAP, HTTP et XML). Cela est bien normal pour le consortium qui est responsable de la rédaction de la plupart des protocoles cités. L'article de Wikipédia donne une définition plus ouverte, allant jusqu'à distinguer des grands types de services Web.
Pour l'ensemble de ce cours, nous opterons pour une distinction entre Web API et Web service qui s'impose de plus en plus dans la littérature. Une API Web (parfois nommée RESTful Web Services) est une interface programmatique basée sur HTTP permettant à un client et à un serveur d'interagir suivant un échange de requête/réponse. Un service Web est un protocole de communication basé sur les standards W3 tels que XML, SOAP et WSDL.
Ce cours porte principalement sur les API Web au travers d'un approfondissement des connaissances sur le protocole HTTP et une présentation du modèle d'architecture REST. Les services Web proprement dits sont présentés dans les annexes pour celles et ceux qui désirent une introduction aux protocoles SOAP et WSDL.