OpenAPI (Swagger) のコード生成から通信処理を分離してスキーマ定義だけを利用する - 24/7 twenty-four seven

背景 今関わっているプロジェクトではOpenAPIを利用して、APIのスキーマを定義しています。 OpenAPIではスキーマ定義からクライアントコードを生成できます。 しかし、デフォルトのコード生成はスキーマ定義とネットワーク通信のコードが強く結びついており、使いにくい場面があると感じていました。 認証等がなく、単純なGETだけのエンドポイントを相手にしている場合はそうなっているのは便利だと思いますが、今のプロジェクトでは リクエストヘッダに認証トークンおよびアプリの情報を示す情報を追加する （デバッグビルドでは）リクエスト前と後にログ出力をする アクセストークンの期限が切れた場合は自動的にアクセストークンをリフレッシュし、シームレスにリトライする すべてのエンドポイントで発生しうるエラー（サーバーエラーの5xxや、クライアントエラーの4xx、強制アップデートや緊急メンテナンスなど）と、個