Slide 21
Slide 21 text
Copyright © FINATEXT. All rights Reserved. 20
直近の取り組みについて
swagger-merger で巨大な Swagger ファイルを管理
● 課題: Inspire API の Swagger YAML ファイルだけで 7000行ぐらいあってメンテが大
変だった
○ ファイルを分割して $ref Syntax を使ってファイル参照できるようにしたい
○ ただし API 仕様を確認する時は1つのファイルで閲覧したい
● swagger-ui と swagger-merger を docker-compose で走らせながら編集する
○ まず Swagger ファイルの paths, schema, parametersの定義をファイル分割
○ swagger-ui でyamlファイルを編集しながら、プレビューを確認
○ swagger-merger で yaml ファイルの編集をwatch して統合したファイルを編集の
都度生成する
○ 編集後、個別のyaml ファイルと統合されたyamlファイルをgithub管理