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

Difference between Swagger and OpenAPI

Difference between Swagger and OpenAPI

I gave a presentation in my office with this deck.

Avatar for Shintaro Ikeda

Shintaro Ikeda

December 11, 2019
Tweet

More Decks by Shintaro Ikeda

Other Decks in Technology

Transcript

  1.  Swagger  Swagger  RESTful API:= .$-.#+.&,. RESTfulAPI25 3509

    7 .*>84  → ?;!'- !%(".)-!/  SmartBear 1<6 '-  
  2. The easiest way to understand the difference between OpenAPI and

    Swagger is: OpenAPI = Specification → SpecificationYaml   Swagger = Tools for implementing the specification → OpenAPIRESTful API
  3. Swagger tools Swagger Editor: Swagger Editor lets you edit OpenAPI

    specifications in YAML inside your browser and to preview documentations in real time. Swagger UI: Swagger UI is a collection of HTML, Javascript, and CSS assets that dynamically generate beautiful documentation from an OAS- compliant API. Swagger Codegen: Allows generation of API client libraries (SDK generation), server stubs and documentation automatically given an OpenAPI Spec. Swagger Parser: Standalone library for parsing OpenAPI definitions from Java Swagger Core: Java-related libraries for creating, consuming, and working with OpenAPI definitions Swagger Inspector (free): API testing tool that lets you validate your APIs & generate OpenAPI definitions from an existing API SwaggerHub (free and commercial): API design and documentation, built for teams working with OpenAPI.   SmartBear (Inspector, Hub )Open Source 
  4. RESTful  *&'  vs GraphQL vs gRPC (Protocol Buffers)

     2 (+%) curl # !  $"Visualize  etc