Swagger で覚えたこと、ハマったことをメモしていく Swagger と JSON schema の位置づけ Swagger は API を定義するためのもの JSON schema は JSON のデータ構造を定義するためのもの JSON Hyper-Schema も API を定義するためのもの 対比するとしたら Swagger <-> JSON Hyper-Schema Swagger <-> JSON schema ではない 現に Swagger の型定義は JSON schema が使われてる Swagger と JSON Hyper-Schema の比較 Pros swagger-ui かっこいい codegen に言語いっぱい Cons JSON Schema 準拠とはなんだったのか JSON Schema の抽出してくれるやつがない committee がない ドキュメ
![Swagger についての覚書 - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/e48e4b7db1dc5cbe0238c8fef29f014937553421/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fcdn.qiita.com%252Fassets%252Fpublic%252Farticle-ogp-background-412672c5f0600ab9a64263b751f1bc81.png%3Fixlib%3Drb-4.0.0%26w%3D1200%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTk3MiZoPTM3OCZ0eHQ9U3dhZ2dlciUyMCVFMyU4MSVBQiVFMyU4MSVBNCVFMyU4MSU4NCVFMyU4MSVBNiVFMyU4MSVBRSVFOCVBNiU5QSVFNiU5QiVCOCZ0eHQtYWxpZ249bGVmdCUyQ3RvcCZ0eHQtY29sb3I9JTIzMjEyMTIxJnR4dC1mb250PUhpcmFnaW5vJTIwU2FucyUyMFc2JnR4dC1zaXplPTU2JnM9M2IyYjM2MGNjMzViY2JmYTY5OWY4YjA0ZGRkY2VlZmU%26mark-x%3D142%26mark-y%3D57%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZoPTc2Jnc9NzcwJnR4dD0lNDBtdHNtZm0mdHh0LWNvbG9yPSUyMzIxMjEyMSZ0eHQtZm9udD1IaXJhZ2lubyUyMFNhbnMlMjBXNiZ0eHQtc2l6ZT0zNiZ0eHQtYWxpZ249bGVmdCUyQ3RvcCZzPWYzZDVmZTgxOTgyN2JkZDhmMmIwZTcxZTg0MmU2OGQ2%26blend-x%3D142%26blend-y%3D436%26blend-mode%3Dnormal%26txt64%3DaW4gUXVpcHBlciBMaW1pdGVk%26txt-width%3D770%26txt-clip%3Dend%252Cellipsis%26txt-color%3D%2523212121%26txt-font%3DHiragino%2520Sans%2520W6%26txt-size%3D36%26txt-x%3D156%26txt-y%3D536%26s%3Dcc55dc877d8716d3c0416b4816ed8c5c)