APIエコノミー友の会V2のプレゼン資料です

1. 1
2017/07/05
APIエコノミー推進部
槌野 雅敏
サイオステクノロジー株式会社
APIエコノミー友の会 V2
「Swagger」によるAPI仕様の管理と標準化

2. © SIOS Technology, Inc. All rights Reserved.
APIマネジメントのおさらい
2

3. © SIOS Technology, Inc. All rights Reserved.
APIマネジメントのソリューション
APIマネジメント
ホストサーバ
(APIの実体)
クライアント
HTTP/HTTPS
HTTP/HTTPS
API セキュリティ
サービスの
品質維持、価値向上
• API 利用の認証
• 開発者に応じて提供可能な API の制限
• 外部からの攻撃からの防御
• バックエンドのサービスレベルを保つための
API トラフィック量の制限
• API 利用の際のレスポンスタイムの低遅延化
• API のバージョン管理
開発者やパートナーの
管理、支援
• 開発者が利用しやすい API ドキュメントの提供
• 開発されたアプリケーションにてAPI がどれだけ利用されてい
るかの分析
• (オープン API の場合)開発者をあつめるための活動
利用状況のトラッキング
• キャッシュ利用を含めたアクセス数の把握・管理
• 従量制のAPI利用料を徴収するサービス形態

4. © SIOS Technology, Inc. All rights Reserved.
APIマネジメント製品の概要比較
Mashery Apigee Azure 3scale Kong
開発 TIBCO Software Google Microsoft Redhat Mashape
ライセンス Commercial Commercial Commercial Commercial OSS/Apache 2.0
サービス利用形態 SaaS/OnPre SaaS/OnPre SaaS SaaS/OnPre OnPre
ミドル周り 非公開 非公開 非公開 Nginx/plugin(*) OpenResty(Lua)
管理機能 GUI GUI GUI GUI CUI (REST API)
認証・セキュリティ ○ ○ ○ ○ ○
トラフィック管理 ○ ○ ○ ○ ○
パッケージ化 ○ × × × ×
開発者ポータル ○ ○ ○ ○ △ (Gelato;有償)
モニタリング ○ ○ ○ ○ △ (Galileo;有償)
マネタイズ × △ × △ ×
SIOSからのご提供 ○ × ○ ○ ○
4
(*) java, .NET, Ruby, nodeJS, python, perl, php
弊社ではAPIエコノミーの実現に向け、APIマネジメント製品の導入をおすすめしております。有償製品のみならず、オープンソースの導
入・サポートまで幅広くご支援させていただきます。

5. © SIOS Technology, Inc. All rights Reserved.
Swagger(Open API) Specificationの
仕様には触れません
7

6. © SIOS Technology, Inc. All rights Reserved.
Swagger って何？どんなことができるの？
8

7. © SIOS Technology, Inc. All rights Reserved.
Open API
Specification
Swagger って何？
THE WORLD’S MOST POPULAR API TOOLING
世界で最もポピュラーなAPIツール
9
Swagger
Editor
Swagger
Core
Swagger
UI
Swagger
Codegen
Swagger定義をYAML形式で記述するための
ブラウザベースのエディター
Swagger定義されたAPIを
インタラクティブに探るための
HTML5ベースのUIを提供
Swagger定義からドキュメントや
サーバ/クライアントSDKなどの
コードを生成するフレームワーク
Swagger定義を作成、使用するための
Java関連ライブラリ
(他言語向けのライブラリも沢山ある)
元々はSwagger Specificationと呼ばれ
ていたが、Open API Initiative(OAI)の
設立と共に名称変更がなされた。
Swagger
Hub
APIの設計、ドキュメンテーション、
その他開発を支援する各種ツール
との統合
(例: GitHub, Amazon API Gateway,
Azure API Management, etc..)

8. © SIOS Technology, Inc. All rights Reserved.
Googleトレンドで比べてみた
10
swagger
RAML
API
blueprint
全ての国を対象に過去５年間で比較
https://trends.google.co.jp/trends/explore?q=swagger,api%20blueprint,raml
RAML (RESTful API Markup Language) / Mulesoftが主体となって推進
API blueprint / Apiaryが主体となって推進
JSON Schemaなんてのもあります

9. © SIOS Technology, Inc. All rights Reserved.
開発のアプローチ
11

10. © SIOS Technology, Inc. All rights Reserved.
トップダウン・ボトムアップ
12
Spec.
(YAML)
Source
Code
Swagger Editor Swagger Codegen
Swagger CoreSwagger UI
出力入力出力編集
入力出力入力参照
仕様を決めてソースコードを生成
トップダウンのアプローチ
ボトムアップのアプローチ
ソースコードに実装したアノテーションから
ドキュメントを生成
一昔前にExcel←→DDLの相互変換ツールなどがよ
く使われましたが、分かりやすい例えとしては、
そういうことが実現できます

11. © SIOS Technology, Inc. All rights Reserved.
デモ
13

12. © SIOS Technology, Inc. All rights Reserved.
ご静聴
ありがとうございました
14