Architecture REST & API RESTful Nicolas Perussel 28 Septembre 2017 AFUP BORDEAUX 

ORIGINE DE REST Salut, je m’appelle Roy Fielding et j’ai écrit une thèse en 2000 Architectural Styles and the Design of Network- based Software Architectures  REST veut dire « Representational State Transfer »  La thèse de Roy est dispo ici (Fr) : http://opikanoba.org/tr/fielding/rest/*  REST est une architecture et non un protocole (à l’inverse de SOAP)  REST repose sur HTTP (RFC 7230) 

ORIGINE DE REST "Representational State Transfer évoque l'image du fonctionnement d'une application Web bien construite : un réseau de pages Web (une machine à états finis virtuelle) où l'utilisateur progresse dans l'application en cliquant sur des liens (transition entre états) ce qui provoque l'affichage de la page suivante (représentant le nouvel état de l'application) à l'utilisateur qui peut alors l'exploiter" C’est Roy qui l’a dit ! 

REST - CONSTRAINTS REST is CLIENT-SERVER REST use CACHE REST is STATELESS REST INTERFACE / Uniform Contract REST is based on LAYERED SYSTEM REST CODE ON DEMAND (allow logic within client) 

RMM (Richardson Maturity Model) Salut, je m’appelle Leonard Richardson et je suis à l’origine du : Richardson Maturity Model Martin Fowler m’a rendu célébre ! 

RMM (ZOOM) Single URI and Single HTTP VERB Multiple URI and Single HTTP VERB Multiple URI addressable Resources and Multiple HTTP VERB HATEOAS Hypermedia As The Engine Of Application State 

RMM LEVEL 0 Request send on SAME URL Fuck status code ALWAYS 200 Request send with POST VERB Send XML 

RMM LEVEL 1 Add RESOURCE POST /agenda POST /actualites Hierarchical VIEWS POST /actualites/56 

RMM LEVEL 2 Use HTTP VERB GET, POST, PUT, DELETE GET /actualites/56 POST /actualites PUT /actualites/56 DELETE /actualites/56 Introduce HTTP CODE 1xx : "Je suis en train de bosser, attends encore un peu." 2xx : "Voilà le résultat, ça s'est bien passé." 3xx : "Le contenu est déplacé, va voir ailleurs (cf. en-tête location)." 4xx : "Tu me demandes n'importe quoi, tu as merdé." 5xx : "J'ai merdé... " https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html 

BUZZWORDS (quelques-uns…) 

Qu’est ce qui me veut avec son Level 3 ? 

HYPERMEDIA API découvrables VOCABULAIRES réutilisables FORMATS réutilisables Technique ou système permettant, dans un système Documentaire multimédia, de passer d'un document à un autre selon des chemins préétablis ou élaborés lors de la consultation. 

HYPERMEDIA Types de médias (formats) • Collection + JSON • SIREN • HAL • JSON API • JSON-LD & HYDRA  W3C (2014) Sémantiques (vocabulaires) • Link relations IANA • Schema.org • Microformats 

JSON-LD Format Hypermedia standardisé : recommandation W3C (2014) Easy to use : document JSON standard avec des clés spéciales (@) ==> mapping vers un context Promu par Google, BBC, Microsoft, US & UK gouvernments Adapaté pour le Web semantic : RDF, SPARQL, Triple Store … 

JSON-LD 

Extension de JSON-LD (Draft du W3C) Documentation d’une API JSON-LD Permet à une API d’être auto-découvrable par le client :  Ressources disponibles  Propriétés des ressources  Types et opération  Règles de validations Propose un format standardisé pour :  Collections  Paginations  Filtres  Erreurs … HYDRA 

API PLATFORM RAD API avec API PLATFORM & WEBBY 

API PLATFORM RAD API avec API PLATFORM & WEBBY Gérer vos ressources POUR CHAQUE RESSOURCES:  Choix des verbes * : GET / POST / PUT / DELETE / OPTIONS / HEAD  Choix des propriétés *  Choix des ressources embarquées *  Création de « Controllers » & « Routes » spécialisés FACILITER GRACE AUX ANNOTATIONS ! * 

API PLATFORM RAD API avec API PLATFORM & WEBBY Filtrer vos API facilement • SEARCH : exact, partial, start, end, and word_start • DATE : ?property[]=value • BOOLEAN : ?property=[true|false|1|0] • NUMERIC : ?property=int|bigint|decimal... • RANGE : ?property[lt]|[gt]|[lte]|[gte]|[between]=value • ORDER : ?order[property]= • GROUP: ?groups[]= • PROPERTY : ?properties[]= FACILE JE VOUS DIS ! 

API PLATFORM RAD API avec API PLATFORM & WEBBY Valider vos ressources • Utilise le ValidatorComponent • Validation groups 

API PLATFORM Sérialiser vos ressources • Etant le SerializerComponent • Transforme les objets PHP vers Hydra • Data Providers sont ont cœur du système • Serializer disponibles : • JSON-LD (api_platform.jsonld.normalizer.item) • HAL (api_platform.hal.normalizer.item) • JSON, XML, CSV, YAML (using the Symfony serializer) (api_platform.serializer.normalizer.item) • Facilement (presque) extensible 

API PLATFORM PHP ROCKS ! RAD API avec API PLATFORM & WEBBY 

Merci de votre écoute http://putaindecode.io/fr/articles/api/hateoas/ https://martinfowler.com/ https://json-ld.org/ http://www.hydra-cg.com/ https://api-platform.com/ Sources :