O slideshow foi denunciado.
Utilizamos seu perfil e dados de atividades no LinkedIn para personalizar e exibir anúncios mais relevantes. Altere suas preferências de anúncios quando desejar.

10分でわかるOpenAPI V3

2.408 visualizações

Publicada em

2017/10/6 API Meetup Tokyo #22 LT資料
https://api-meetup.doorkeeper.jp/events/64948

Publicada em: Tecnologia
  • Seja o primeiro a comentar

10分でわかるOpenAPI V3

  1. 1. 10分でわかる OpenAPI V3 2017/10/6 API Meetup Tokyo #22 LT about.me/kazuchika
  2. 2. OpenAPI Specification (OAS)って? API仕様を機械可読な形式(JSON/YAML)で 定義するための標準規格
  3. 3. 何がうれしいの? ドキュメント生成 コード生成(クライアント側SDK、サーバ側スケルトン) テストやモック生成 チーム間のフォーマルな合意文書として 仕様がコード化されるので変更管理もかんたん
  4. 4. Wordnikが Swaggerを開発 2010 OpenAPI Initiative 設立 OAS 2.0としてcontribute (OAS 2.0 = Swagger 2.0) 2015 2014 Swagger 2.0 2017 OAS 3.0!WSDLとかWADL とかの時代 SwaggerからOASへ
  5. 5. https://www.openapis.org/membership/members OASは業界標準に
  6. 6. V3登場! 2017/07/26正式リリース https://www.openapis.org/blog/2017/07/26/the-oai-announces-the-openapi-specification-3-0-0 主な変更点 1.脱”Swagger”化 2.構造の整理 3.細かい改良
  7. 7. 実装状況 GitHubに「Implementations」情報あり(必見) https://github.com/OAI/OpenAPI-Specification/blob/master/IMPLEMENTATIONS.md OAI参加各社の製品・サービスでのV3サポートは半年くらいがメドか
  8. 8. 試してみよう V2→V3コンバータ https://openapi-converter.herokuapp.com/ エディタ(V3対応) http://editor.swagger.io/ swagger: "2.0" info: version: "1.0" title: HelloWorld API description: Minimum swagger example. paths: /hello: get: description: Gets greeting message. parameters: - name: target in: query description: Who to greet required: false type: string responses: 200: description: Successful response. schema: type: object properties: message: type: string
  9. 9. まとめ API仕様はOpenAPI Specificationで記述しよう! すぐのproduction useならV2、そうでなければV3で! 脱”Swagger”!

×