3.5.2.Swagger/OAI Specifications Walkthrough

• Open API initiative

  • Open API initiative (OAI) is focused on creating, evolving and promoting a vendor neutral API

  • Description format based on the Swagger specification

  • current version: v2.0

    • JSON

    • YAML

      • Readable & understandable

      • Data serialization language like XML, JSON

      • superset of JSON

        • 用indentation取代<>, {}

          //JSON
          "swagger": "2.0",
          "info": {
            "title": "uber API",
            "description": "Move your app forward with the Uber API",
            "version": "1.0.0"
          }
          
          //YAML
          "swagger": "2.0",
          "info"
            "title": "uber API"
            "description": "Move your app forward with the Uber API"
            "version": "1.0.0"

      • Online editor