Solutions for API Design and Management | Stoplight
API excellence made easy.All of the benefits of innovation without the headaches. Create a Successful API ProgramTake a proactive approach with your API programs to efficiently create consistent productivity and avoid the underbelly of delays and overages. Reduce Risk and Improve ROIConnected Software is mandatory for today’s consumers. Avoid disorganized development efforts that cause significant
Dockerを使ってswagger.yamlをサクッとみる (swagger-ui 3.x) - Qiita
swagger-uiの3.xが出ました 個人的に大きく変わったなと思うポイントは、以下の二点です。 YAMLの読み込みがサポートされた swaggerのspecの書式はJSONとYAMLの２種類が用意されているのですが、swagger-ui 2.xではJSONしかサポートされていなかったので、YAMLをJSONに変換して読み込ませる必要がありました 見た目がガッツリ変わった deprecatedとかが地味だったのがわかりやすく表現される様になりました ローカルで動かすのが楽になった 以前こんな記事を書きました。 SwaggerでAPIを定義してインタラクティブAPIドキュメントを見る Dockerを使ってswagger.yamlをサクッとみる このときに比べてswagger周辺のツール群も洗練されてきたので、それに合わせてさくっと見る方法の最新版を書きます。 公式Dockerイメージが有る
中規模のSwaggerファイルをいい感じに管理するために薄いフレームワーク作った - swglow
今回の成果物 Swaglow https://github.com/chuross/swaglow 特長 特定のルールに基づいたディレクトリ階層から、SwaggerのYamlファイルを結合して出力する。 SwaggerのYaml運用に最低限の秩序をもたらす フレームワークが生成したディレクトリに沿ってファイルを追加していくので、ファイル管理をルール化しやすい ディレクトリ階層や名前からpathsやdefinitionsの定義を自動生成 最終的なYamlがどう生成されるのか意識する必要は無い Yamlファイルを個別に管理していくことに集中できる 経緯 Swaggerで扱うYaml(or Json)は最終的には1つのファイルとして扱わないといけないが、何も考えずにそれに乗っかるとファイルが肥大化して管理しづらくなる。 そのためYamlを分割して結合するのが良く、npmにも既にそれを実現するライ
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
GitHub - chuross/swaglow: simple swagger framework
Protocol Buffers周辺の考え方と生態系についての議論
GitHub - nytimes/openapi2proto: A tool for generating Protobuf v3 schemas and gRPC service definitions from OpenAPI specifications
まだAPI定義管理で消耗してるの？〜Swaggerを用いた大規模アプリ時代のAPI定義管理とコードジェネレート〜
