Slide 1

Slide 1 text

Swagger OpenAPI RESTful Source article: https://swagger.io/blog/api-strategy/difference-between-swagger-and-openapi/ Shintaro Ikeda 2019-12-11

Slide 2

Slide 2 text

Swagger Swagger RESTful API:=.$-.#+.&,. RESTfulAPI25 3509 7 .*>84 → ?;!'- !%(".)-!/ SmartBear 1<6'-

Slide 3

Slide 3 text

' $&! swagger"!3.0 %)OpenAPI (^o^)v Swagger" # *(+ !!!

Slide 4

Slide 4 text

The easiest way to understand the difference between OpenAPI and Swagger is: OpenAPI = Specification → SpecificationYaml Swagger = Tools for implementing the specification → OpenAPIRESTful API

Slide 5

Slide 5 text

OpenAPI RESTful API (Yaml)

Slide 6

Slide 6 text

OpenAPI ! SmartBearGoogle

Slide 7

Slide 7 text

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

Slide 8

Slide 8 text

Swagger) "% $!,4 RESTful API32'0 "%((/+3321#&-*) . !

Slide 9

Slide 9 text

RESTful *&' vs GraphQL vs gRPC (Protocol Buffers) 2(+%) curl # ! $"Visualize etc