03:28:20このエントリでは、WebサービスのAPI開発を効率良く進めるために、aglioとdrakovを使って、API仕様書とMockを生成する手順を整理したいと思います。aglioはHTMLで仕様書を生成するツール、drakovはMockサーバです。仕様書及びMockサーバを生成します。Blueprinthttps://apiblueprint.org/環境の準備ndenvでnode.jsをインストール以下のように、ndenvでnode.jsをインストールします。ndenvについては、以下を参照。以下のように、作業ディレクトリを作成します。作業ディレクトリ以下で使用するnode.jsを指定します。initで「package.json」を作成します。聞かれますが、とりあえず全て既定値(ひたすらEnter)で回答しておきます。以下のようなAPI仕様のサンプルを作成します。World!API仕様書の生成aglioのインストールnpmでaglioをインストールします。以下のコマンドで起動し、ブラウザで3000ポートにアクセスすると、次のようなAPI仕様書を確認できます。以下のコマンドで、API仕様書のHTMLを出力することができます。doc/message.htmlCIツールなどで、複数のapibファイルからHTMLを生成したい場合は、gulp-aglioを使ってgulpから実行するとよいとかと思います。npmhttps://www.npmjs.com/package/gulp-aglioMockサーバの実行drakovのインストールnpmでdrakovをインストールします。以下のコマンドで、APIのMockサーバを起動できます。--watch以下のようにAPIを呼び出すと仕様に記載した応答を返却することが確認できます。World!localhost以外からMockを使用したい場合は、--publicオプションを使います。