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 full-size slide

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

    View full-size slide

  3. Bien plus qu'une application

    View full-size slide

  4. Equipe Mobile
    Equipe API
    Organisation

    View full-size slide

  5. Description de l'API
    Méthodes Ressources

    View full-size slide

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

    View full-size slide

  7. Les Schémas JSON

    View full-size slide

  8. Les Schémas JSON : références


    View full-size slide

  9. 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 full-size slide

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

    View full-size slide

  11. 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 full-size slide

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

    View full-size slide

  13. HATEOAS
    Richardson Maturity Model

    View full-size slide

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

    View full-size slide