Postmonとは
HTTPのメソッドを通して行なったリクエストの結果を、簡単に確認できるようにするツール。
APIを構築する時、ブラウザからHTTPリクエストをサーバーに出すことになる。Postmanを使うと、HTTPのリクエストを確認し、REST APIが機能しているかを、簡単にチェックすることができる。
インストール方法
「Download Postman for Mac」https://www.postman.com/downloads/
上記のページよりダウンロードする。
アカウントを作成し、Sign inする必要がある（googleアカウントでもサインイン可能）
APIからのリクエストを確認する
テストのためのファイルを作成
＜作成方法１＞
・「＋New」をクリックし、「Request」を作成
・リクエストに名前をつける。HTTPの動作を確認する「Collections」を作成
・request name: テストしたい、APIのHTTPリクエスト名
（例：GETをテストしたいのか、DELETEをテストしたいのか、など）
・create folder: テストのためのフォルダーを作成。Postman上の既存のフォルダーに付け加えることもできる
・「Save to APIアプリ名」で保存
＜作成方法２＞
・「＋New collection」
・「Name」にコレクション名（テストしたいアプリ名）をつけて「Create」
・「...」をクリックし「Add request」を選択
・request name（テストしたいHTTPリクエストの名前）をつける。
・「save to コレクション名」をクリックし保存
使ってみよう
①データをgetする
・テストしたいAPIのURLを入力
・テストしたいHTTPメソッドを選択（今回はGET）
・「send」をクリック
↓
「Body」にHTTPのレスポンスが表示される
②データをpostする
・テストしたいAPIのURLを入力
・テストしたいHTTPメソッドを選択（今回はPOST）
・POSTしたいデータをPostman上から入力する
「Body」>「raw」>「JSON」を選択し、POSTしたいデータをJOSN形式で書き込む。
・「send」を押してデータをPOST
↓
「Body」にHTTPのレスポンスが表示されるので、データがPOSTできているか確認する
＜参考＞今回のアプリで使用したコード
constexpress=require('express');require('./db/mongoose')constUser=require('./models/user')constTask=require('./models/task')constapp=express()constport=process.env.PORT||3000//postしたデータを受け取る処理app.use(express.json())app.post('/users',(req,res)=>{constuser=newUser(req.body)//.save()でPromiseオブジェクトを作成し、インスタンスをデータベースに保存user.save().then(()=>{res.send(user)}).catch((e)=>{//.catchでエラー時の処理を分岐させるres.send(e)})})HTTPステータスを操作する
①返ってくるHTTPステータスの確認
「Body」に表示されるHTTPのレスポンスの「status」を確認。
ここに表示されているのが、返ってくるHTTPステータス
②返ってくるHTTPステータスの変更
app.post('/users',(req,res)=>{constuser=newUser(req.body)//.save()でPromiseオブジェクトを作成し、インスタンスをデータベースに保存user.save().then(()=>{res.status(201).send(user)}).catch((e)=>{res.status(400).send(e)})})返ってくるHTTPステータスは「.status()」で設定できる。
Postmanでレスポンスを確認する際はstatus欄も確認する。
＜参考＞HTTPステータスの一覧と意味
HTTP Status Codes
https://httpstatuses.com/