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

1. 10分でわかる
OpenAPI V3
2017/10/6 API Meetup Tokyo #22 LT
about.me/kazuchika

2. OpenAPI Specification (OAS)って？
API仕様を機械可読な形式(JSON/YAML)で
定義するための標準規格

3. 何がうれしいの？
ドキュメント生成
コード生成（クライアント側SDK、サーバ側スケルトン）
テストやモック生成
チーム間のフォーマルな合意文書として
仕様がコード化されるので変更管理もかんたん

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. https://www.openapis.org/membership/members
OASは業界標準に

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. 実装状況
GitHubに「Implementations」情報あり（必見）
https://github.com/OAI/OpenAPI-Specification/blob/master/IMPLEMENTATIONS.md
OAI参加各社の製品・サービスでのV3サポートは半年くらいがメドか

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. まとめ
API仕様はOpenAPI Specificationで記述しよう！
すぐのproduction useならV2、そうでなければV3で！
脱”Swagger”！