例えば、 OpenAPI の定義がこうなっていたとします。レスポンスのプロパティとして、 name と size があります。 responses: 200: description: 正常系 content: application/json: schema: type: object properties: name: type: string size: type: intege…

この記事について go-swagger について swagger 周辺ツールを使う際の注意点 最新の Swagger Specification に対応しているかどうか 生成される成果物の質に関するリスク Swagger 依存が高すぎないかどうか まとめ この記事について 僕は、go-swagger を使っ…

はじめに Dictionary, ハッシュマップ, 連想配列 additionalProperty とは additionalProperty を利用してDictionaryを書く まとめ はじめに OpenAPのドキュメントの以下のページの訳的なブログです。 Dictionaries, Hashmaps, Associative Arrays Dictionar…

Dreddとは OpenAPI 3.0対応 Dreddとは DreddとはOpenAPI（Swagger） *1 のSpecificationを元にAPIを叩いてレスポンスが正しいかをチェックしてくれるツールです。 github.com OpenAPI 3.0対応 Dreddですが、OpenAPI3.0がリリースされたあともなかなか対応さ…

はじめに 最近のリリース Open API 3 は？ おわりに はじめに Dreddがすごい勢いでリリースされている。DreddはSwaggerで書かれたAPI仕様を元に実際にAPIを叩き、仕様と実装があっているかどうかをチェックするツールである。 github.com 最近のリリース htt…

SwaggerをGitHubで管理したい やりたいことまとめ どう実現するか 導入方法 OpenAPI 3.0 Specificationのファイルをdocs以下に置く GitHubにPushして確認 まとめ 参考 SwaggerをGitHubで管理したい SwaggerをGitHub(Git)で管理したい場合があるかと思います…

もくじ もくじ はじめに とりあえず参考リンクたち yamlを分割したいんだけど bootprint-openapi Swagger-ui はじめに Swaggeを実践投入するにあたりどのように管理していこうかというのを考えるメモ とりあえず参考リンクたち swaggerはソースコードと同じ…