Tweet
Tweet

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