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.

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