Des API web robustes avec les JSON Schemas

Retrouvez la démo sur Github : https://github.com/naholyr/demo-json-schema

Transcript

1. Des APIs Web Robustes
   Grâce aux JSON Schemas
   

   View Slide

2. Nicolas Chambrier (@naholyr)
   Expert technique,
   développeur PHP/Node
   Antoine Hérault (@Herzult)
   Consultant développeur
   chez
   &
   

   View Slide

3. Bien plus qu'une application
   

   View Slide

4. XML
   

   View Slide

5. JSON
   

   View Slide

6. Equipe Mobile
   Equipe API
   Organisation
   

   View Slide

7. Description de l'API
   Méthodes Ressources
   

   View Slide

8. Ben les gars, restez
   sur XML, ya les outils
   pour ça !
   

   View Slide

9. Les Schémas JSON
   

   View Slide

10. Les Schémas JSON : références
    …
    …
    

    View Slide

11. Génération de la DOC
    « A Node.js build tool for generating
    HTML documentation from JSON
    schemas. »
    "npm is the new apt-get" ;)
    ● Créer ses templates
    ● " "
    ● Done !
    

    View Slide

12. Validation
    Démo de validation en ligne de commande
    ● Des messages d'erreur clairs
    ● Utiles à l'utilisateur et/ou à la machine
    

    View Slide

13. Et dans la vraie vie ?
    ● Google API Discovery
    ● Composer configuration
    ● Idées :
    ○ Générer des formulaires depuis les schémas
    ○ Offrir au client de quoi faire une vraie validation
    

    View Slide

14. Implémentations
    ● Java
    ● PHP
    ● JavaScript
    ● Python
    ● Ruby
    ● …
    ● Faire communiquer des services entre eux basés sur JSON
    Schema
    

    View Slide

15. HATEOAS
    Richardson Maturity Model
    

    View Slide

16. HATEOAS
    

    View Slide

17. Démo !
    Validation côté client automatisée
    

    View Slide