読者です 読者をやめる 読者になる 読者になる

Swagger 用の IDE RepreZen API Studio を試してみた

Twitter の DM で使ってみてよって言われたのでちょっと触ってみました。 RepreZen API Studio: A true IDE for Swagger–OpenAPI 使うには、名前とメールアドレスと会社URLが要りましたが、会社URLは必須じゃなさそう(個人のURL)でもいけました。 必要要件は…

Swagger の拡張メモ その2

neuecc/LightNode · GitHub が新しい Swagger UI に対応したっていうのを見かけたので、こっちも見直してみようかなと。 *1 Swagger 拡張のメモ - お だ のスペースからの変わった点のメモ。 Swagger のバージョンを 1.5.2-M1 から 1.5.0 にしました。*2 大…

Swagger JAX-RS で同名のクラスを ApiModel にする時の注意点

メモ:Swagger JAX-RS で同名のクラス(別パッケージ)を ApiModel(戻り値) として定義する時に気を付けること。 Swagger のバージョンは 1.5.2-M1 です。 吐かれる JSON 内の Model 定義には、クラスの simpleName が使われます。 パッケージ違いを考慮しない…

Swagger 拡張のメモ

個人的なメモ。 Swagger 2.0 についての説明は本家や適当に調べて下さい。 REST APIを記述せよ!Swagger紹介 #apijp - Groovyラボ Swagger の紹介されているサイトでは、WebAPI と Swagger UI を同居させるパターンが多くて、public なサービスだと良いのか…