Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Des API web robustes avec les JSON Schemas

Des API web robustes avec les JSON Schemas

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

Nicolas Chambrier

November 29, 2012
Tweet

More Decks by Nicolas Chambrier

Other Decks in Programming

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