Postmanオンラインワークショップ - Postman入門 復習（Web版）前編



[Postmanオンラインワークショップ - Postman入門](https://postman.connpass.com/event/305207/)

実際に手を動かたハンズオンの部分について忘れないうちに復習を兼ねて操作を記録しておきます。ちょっと長くなったので前編、後編に分けたいと思います。


まずは今回のオンラインワークショップで一番大事なところです。WEB版でも日本語表示になります。

# WEB 版でも日本語表示にする

右上にある、SettingsアイコンをクリックしてSetteingsを選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/d536088f-e36b-f2dd-4a48-f37b492f95a1.png)

スクロールしてください。言語の部分で「日本語」を選択して右上の×をクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/30790518-fdb8-d57f-33fe-2373a9207dd8.png)

これで日本語表示になります。素晴らしい

# ラーニング教材をワークスペースにフォーク

以下にアクセスすると、教材のコレクションが表示されます。

www.postman.com/postman/workspace/postman-japan-workshop/


今回使うのは以下のコレクションです。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/cb16368c-1bdf-7dac-d429-8bc56f504341.png)

以下の部分にカーソルを持っていくと ... が表示されるので、選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/eb99cc72-b1b9-16ab-277b-f50b79d5accf.png)

フォークを作成をクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/256272d8-40e0-e97b-6a56-56559fcee552.png)

フォークラベルに分かりやすい名前をつけます。
ワークスペースは個人用に設定した My Workspaceを選択します。
コレクションをフォークをクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/995116d1-b594-dc5a-295f-0ae09f8e1194.png)

これで準備ができました。


# 1. リクエスト送信 & レスポンス検証

### 本の一覧を取得する

送信ボタンをクリックすると本の一覧が取得できます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/c1cf9547-f56f-f047-6f00-817596044ffd.png)


以下のアイコンをクリックするとネットワークの情報を参照できます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/981fcc97-d7b1-12ab-8b98-0420f328f1e4.png)

ステータスをクリックすると、説明が表示されます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/55724846-9d91-54d6-c14f-57975960c95f.png)

時間をクリックするとそれぞれのイベントにかかった時間が表示されます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/ff142702-f25c-0968-9b00-9ba503f313f0.png)


### idを指定して１冊の本の詳細情報を取得します。

:id　と指定するとパス変数として使えます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/c2d4dfc3-e1c4-63cd-b45f-13e1f4db464d.png)

:idを入力して送信ボタンをクリックすると本の詳細情報が表示されます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/9541da1b-4c7f-4e82-fbb5-d301b830b109.png)

### 新しく本を登録します。

以下のようにBodyを設定して、送信ボタンをクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/641c0e18-e4c1-318c-43d0-3790410e044c.png)

成功すると、以下のように応答が表示されます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/594bc456-cf2e-2c56-6927-33f4faa920e1.png)

今回は201が返ってきます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/ef039baa-7f6b-f653-8c97-7595109a4b4b.png)


### 本の情報を更新します。

パス変数に更新する本のIdをセットします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/20e3f363-aec0-fa25-5211-3d627928158d.png)

Bodyには更新する項目と値をセットします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/3f5e6ce6-a1d2-eccd-cc6f-cc73bfe03a03.png)

本を検索して更新されているかを確かめます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/6d2bfb7c-ea91-efd5-cf80-313bf1c87f02.png)

checkedOut 項目がtrueに更新されています。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/1a17eaf3-c3bc-1508-60ac-7ed733bacba0.png)

存在しないIdで更新するとエラーになるかを確かめます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/b13fe536-aa6f-55a3-9658-d068bde404cc.png)


### 登録した本を削除します。

正しい本のIdをセットして送信をクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/cbe943e0-1d66-a665-d0a7-66f745fee736.png)

本当に消されたかを確かめます。先程のIdをセットして検索します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/91894d61-b762-ebe0-223e-80bb1d176717.png)


# 2. レスポンスのテスト


テストタブをクリックして以下のコードを入力します。
入力したら保存ボタンをクリックして、送信をクリックします。

```
pm.test("ステータスコードチェック 200", function () {
   pm.response.to.have.status(200);
});
```



![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/69c2ac04-9e70-ea77-017b-37c410c2edc4.png)


テスト結果を確認します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/f240ca9b-7f75-4e25-6711-5ef0eec9a8ca.png)

テストスクリプトが無い場合は、このようになっています。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/c9a8e63b-a468-5f19-a516-c3654697119b.png)

テストが失敗するように書き換えてみます。保存してから送信ボタンをクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/6f21cd0c-775e-c81f-16d0-784d3859d2d9.png)

テスト結果をみると失敗しています。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/766da5b3-90f3-55e3-6625-86451b81c288.png)

複数のテストも作成できます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/597dfdef-f2e7-2a71-9eab-fd4c62f6691e.png)

結果も複数表示されます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/e238dee1-f64b-1eb4-5a2d-fe18124546e4.png)

参考：Pre-requestスクリプトは、Request body等を動的に作成する用途で使用できます。またヘッダの中身もチェックできます。

+ [Postman でテストを作成する](https://qiita.com/Keiji_otsubo/items/b44e0cc10b9af7d79875)

# 3. レスポンスのサンプルを保存する

送信ボタンをクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/b1b4bdbd-e9b4-9f55-07d8-2cd37c97b945.png)

サンプルとして保存ボタンをクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/3fdb5478-3d73-cbf5-9e19-d4ebf82dc5b6.png)

サンプルが保存されたので分かりやすい名前に変更します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/62850fb8-b761-b7b0-59c2-8e999e706261.png)



![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/7cc5eb01-17c5-b8b5-f633-5babf5476033.png)