OpenAPIを利用したPythonWebアプリケーション開発

2017年時点(OAS v3.0直後くらい)のPythonでの事例紹介。

プレゼン資料

https://www.youtube.com/watch?v=wcxgndDlSVk&feature=youtu.be

要約

OpenAPIってなに

APIツールに使う

Coreツール

https://github.com/swagger-api 以下で開発されている

shimizukawa.icon 2020/08/30時点では https://github.com/OpenAPITools の方が活発？

Python関連ツール

Pythonのクライアントコード生成、サーバーコード生成

OpenAPIの利用事例

クライアント(JS)をSwagger CodeGenで生成

ドキュメントをSwagger-uiで生成

サーバーのバリデーション処理を bravado-coreで実装

別サーバーへアクセスするコード(Python)をSwagger CodeGenで生成

開発フロー

API設計しOAS記述

Frontend

OASからAPIクライアント生成

OASからモックサーバー生成

Backend

OASで自動バリデーション

良かった点

OASを全く使わない場合に比べて非常に工数を削減できる

FrontendとBackendを独立して開発できる

気になる点

OASを覚えないといけない(学習コスト)

参考

タグ