まとめ面倒な前置きは一旦省きましょう!ここではSwaggerの説明をしますが、こんな人をターゲットにしています。Swaggerで何が出来るのかよく分かんない人なんだかよく分かんないけどSwagger使ってカッコイイAPIの仕様書が作りたい人Swagger使ってみたけど無駄に長いペットショップのサンプルにうんざりしている人では今回も初めて行きます。そもそもSwaggerってなにが出来るんだSwaggerを使うとAPIの仕様書を作れます。作ったAPIのモックサーバーが自動で作れます。テスト用のクライアントが自動で作れます。便利そうな機能があるのでぜひ使ってみたいと思うこと間違いなし。Swaggerにはいくつかツールがあるのですが、とりあえずはエディターを使ってみましょう。仕様書を作る為のエディターです。使うには以下のように大体3つくらい選択肢があります。使うローカルにインストールして使うエディタのプラグインで使う1.はお手軽。WEBサービスでも提供されているのでブラウザでアクセスするだけで制限なしに利用することができます。2.はローカルにインストールして使う方法です。業務的な関係でインターネットでの編集はちょっとという人にはいいんではないでしょうか。専用のコンテナがあるのでインストールもそんなに難しくないです。Codeの様なエディタのプラグインとして使う方法です。こちらもプラグインをインストールするだけなので特に難しいことはありません。要するにどの方法でもお手軽に使うことができるので導入は問題ないでしょう。今回はWEBのEditorを使って行きましょう。ペットショップのサンプルを表示させるWEBのエディタを開くと画面左にエディタ、右には作成されたAPI仕様書が表示されています。更新するとすぐに右の仕様書に反映され行きますのでせっかちな人も快適に使えます。WEBエディタを開くとペットショップのAPIサンプルが表示されています。文法についてはいずれ紹介して行きます。選択しエディタを綺麗にしましょう。めでたくサンプルが復活します。それぞれモックサーバとモッククライアントの自動作成することができます。選択すると様々な言語、フレームワークで作成されたモックを利用できます。希望の言語、フレームワークを選択するとzipファイルがダウンロードされますので任意のフォルダに展開します。展開したフォルダ内にはそれぞれREADMEファイルがあると思うので指示に従っていくとモックを利用することができます!モックサーバにアクセスするとAPI仕様書が表示がされ、しかもその仕様書の中でリクエストのパラメータを設定して通信テストを行う事ができます。通常、仕様書を作成しても本当にその通りに通信ができるかはサーバを作らないと分からないのですが仕様書からモックサーバがそのまま作成されるのですぐに確認できて効率が良くなります。...pandasで入れ子になったtableがあるhtmlを読込む業務でここのところずっとPythonを使っています。...Nginxの設定ファイルいじったらプロセスが閉じなくなったNginx使ってみたのですが、ちょっとあれって思ったので。Highlightを使ったら<>が自動変換されてしまう技術系ブログを書こうと思ったらやっぱりコードを載せないと話になりません。コメントをキャンセルメールアドレスが公開されることはありません。...3連休初日のドラクエウォークとメタルスライム3連休始まりましたねー。今日は1日ゆっくりと家で。...ランニングで試してみたWALKモードの効率はいかにさてドラクエウォークで始めるダイエットは2日目です。...DQWことドラクエウォークで始めるダイエットへの道そろそろ痩せないとまずい。