QAエンジニアにもおすすめ。Postmanで始めるやさしいAPIテスト
株式会社hacomono / 蛯子将樹
メンバー / QAエンジニア / 従業員規模: 301名〜500名 / エンジニア組織: 101名〜300名
| 利用プラン | 利用機能 | ツールの利用規模 | ツールの利用開始時期 | 事業形態 |
|---|---|---|---|---|
Free | Collection, Environment, Script(Pre-request/Post-response) | 10名以下 | 2024年6月 | B to B |
| 利用プラン | Free |
|---|---|
| 利用機能 | Collection, Environment, Script(Pre-request/Post-response) |
| ツールの利用規模 | 10名以下 |
| ツールの利用開始時期 | 2024年6月 |
| 事業形態 | B to B |
導入の背景・解決したかった問題
導入背景
ツール導入前の課題
外部向けAPIを新たに提供するというプロジェクトに伴い、テストとして「画面を操作して確認する」という手法が使えないため、どのようにQA(Quality Assurance)でプロダクトの品質を担保するかが課題となっていました。
どのような状態を目指していたか
QAエンジニアだけでもAPIテストが可能となること。
比較検討したサービス
- curl
比較した軸
学習コストの低さ(非エンジニアでも直感的に使えるか)
結果の視認性(レスポンスデータが読みやすいか)
資産の管理・共有のしやすさ(再利用できるか)
導入の成果
改善したかった課題はどれくらい解決されたか
チーム内で誰でもAPIテストが実施可能な状況となり、導入前の課題は解決されました。
どのような成果が得られたか
QAエンジニアの守備範囲が広がり、いままで開発者が確認していたAPIテストに関してもQAで実施することができるようになりました。
導入に向けた社内への説明
上長・チームへの説明
Freeライセンスで実現したいことが達成できたため、上長説明や稟議申請等は行いませんでした。 チーム内への説明は、基本的な使用方法をデモンストレーションしながら行いました。
活用方法
よく使う機能
- APIリクエストの実行とレスポンス確認
- Collections
- Environments
- スクリプト
- Postbot
ツールの良い点
- 直感的で使いやすいGUI
ターミナルで複雑な curl コマンドを叩く必要がなく、メソッド(GET, POSTなど)を選んでURLを入力し、ボタンを押すだけでレスポンスを確認できます。
視認性が高い:レスポンスデータ(JSONやXML)がきれいに整形・色分けされて表示されるため、データの構造がひと目でわかります。
パラメータ設定が楽:ヘッダーやボディの設定も、フォームに入力するだけで完了します。
- 「コレクション」による管理と再利用
作成したリクエストを「コレクション」というフォルダのような単位で保存・整理できます。
履歴の保存:過去に送ったリクエストを保存しておけば、いつでも再実行できます。
構造化:プロジェクトごと、機能ごとにフォルダ分けして管理できるため、APIの数が増えても混乱しません。
- 環境変数によるスムーズな切り替え
「ステージング環境」「本番環境」など複数の環境を環境変数機能を使うことで、これらを簡単に切り替えられます。
URLの書き換え不要:{{base_url}} のように変数化しておけば、プルダウンメニューを切り替えるだけで、接続先を変更できます。
- テストの自動化とスクリプト
JavaScript を使って、リクエスト送信前(Pre-request)やレスポンス受信後(Post-response)に処理を記述できます。
自動テスト:「ステータスコードが200か」「レスポンスに特定のデータが含まれているか」などを実行ごとに判定させることができます。
ツールの課題点
(利用者の課題を含みます)
- 多機能がゆえ、最初はどこを見ればいいか迷う
- シンプルに「リクエストを送って結果を見たいだけ」であっても、画面上にボタンやタブが多くて、最初は圧倒されてしまうかもしれません。
- 自動化や複雑な検証には「コード」の知識が必要になる
- 基本はノーコードですが、一歩進んだことをしようとするとJavaScript 等の知識が必要になります。
- 無料版の制限
- 「Collection Runner」という機能が、無料プランだと実行回数に制限があります。チームで毎日自動テストを回したい場合は、有料プランやNewmanの導入検討が必要になります。 また、同じワークスペースで作業する場合の人数にも制限があります。
ツールを検討されている方へ
PostmanはAPIテストのためのツールとして導入が容易で、かつ多機能なツールです。 まず触ってみるところから始めてみてはいかがでしょうか? ここでは紹介しきれなかった機能に関して、以下ブログで紹介していますのでご興味のある方はぜひ一読いただけますと幸いです。
株式会社hacomono / 蛯子将樹
メンバー / QAエンジニア / 従業員規模: 301名〜500名 / エンジニア組織: 101名〜300名
よく見られているレビュー
株式会社hacomono / 蛯子将樹
メンバー / QAエンジニア / 従業員規模: 301名〜500名 / エンジニア組織: 101名〜300名
レビューしているツール
目次
- 導入の背景・解決したかった問題
- 活用方法


