Postman ユーザーマニュアル：完全ガイド (2026年版)

Postman ユーザーマニュアル：完全ガイド (2026年版)

Postmanは、2026年においても最も広く利用されているAPI開発プラットフォームです。REST APIのテスト、GraphQLエンドポイントの設計、サービスのモック作成、あるいは自動テストスイートの実行など、Postmanはあらゆるタスクを完遂するためのツールを提供します。

この包括的なユーザーマニュアルでは、最初のリクエスト送信から高度な自動化ワークフローまで、すべてを網羅しています。初心者から、Postmanの全機能を一つのリファレンスで確認したい経験豊富な開発者までを対象としています。

はじめに

インストール

postman.com/downloads から Postman をダウンロードしてください。macOS、Windows、Linux で利用可能です。また、go.postman.co ではウェブ版も提供されています。

# macOS (Homebrew経由)
brew install --cask postman

# Linux (Snap経由)
snap install postman

アカウントの作成

アカウントなしでも Postman の Scratch Pad を使用できますが、サインインすることでクラウド同期、コラボレーション、およびほとんどの機能がアンロックされます。無料アカウントは identity.getpostman.com で作成できます。

最初のリクエストを送信する

基本的な GET リクエスト

1. + タブをクリックして新しいリクエストを開きます
2. メソッドのドロップダウンから GET を選択します
3. URLを入力します: https://jsonplaceholder.typicode.com/users
4. Send をクリックします

レスポンスパネルに、レスポンスボディ、ステータスコード、時間、サイズが表示されます。

一般的な HTTP メソッド

メソッド	目的	例
GET	データの取得	GET /api/users
POST	リソースの作成	POST /api/users
PUT	リソースの置換	PUT /api/users/1
PATCH	部分的な更新	PATCH /api/users/1
DELETE	リソースの削除	DELETE /api/users/1
OPTIONS	利用可能な機能の確認	OPTIONS /api/users
HEAD	ヘッダーのみ取得	HEAD /api/users

JSONボディを使用した POST リクエストの送信

1. メソッドとして POST を選択します
2. URLを入力します: https://jsonplaceholder.typicode.com/posts
3. Body タブに移動します
4. raw を選択し、ドロップダウンから JSON を選択します
5. ボディを入力します:

{
  "title": "My Post",
  "body": "This is the content of my post.",
  "userId": 1
}

6. Send をクリックします

ヘッダーの追加

Headers タブに移動し、キーと値のペアを追加します。

キー	値
Content-Type	application/json
Authorization	Bearer your-token-here
Accept	application/json

クエリパラメータ

クエリパラメータは2つの方法で追加できます。

方法 A: URLに直接入力

https://api.example.com/users?page=1&limit=20&sort=name

方法 B: Params タブに入力

キー	値
page	1
limit	20
sort	name

どちらも同じ結果になります。複雑なクエリの場合は、Params タブの方が管理しやすくなります。

コレクション (Collections)

コレクションは、APIリクエストを整理するためのフォルダです。Postmanで効率的に作業するための基盤となります。

コレクションの作成

1. 左サイドバーの Collections をクリックします
2. + または New Collection をクリックします
3. 名前を入力します (例: "User Management API")
4. 説明を追加します (任意ですが推奨されます)

コレクションへのリクエスト追加

コレクションを右クリックし、Add Request を選択します。既存のリクエストをコレクションにドラッグすることも可能です。

フォルダによる整理

コレクション内にフォルダを作成して、関連するリクエストをグループ化します。

User Management API/
  Authentication/
    POST Login
    POST Register
    POST Refresh Token
    POST Logout
  Users/
    GET List Users
    GET Get User by ID
    POST Create User
    PUT Update User
    DELETE Delete User
  Admin/
    GET System Stats
    POST Bulk Import

コレクションの実行

Collection Runner は、コレクション内のすべてのリクエストを順番に実行します。

1. コレクションの Run をクリックします
2. 反復回数 (iterations)、遅延 (delay)、データファイルを構成します
3. Run Collection をクリックします

これは統合テストやデータシーディング（初期データの投入）に非常に強力です。

環境 (Environments) と変数 (Variables)

環境を使用すると、リクエストを変更することなく、異なるAPI設定（開発、ステージング、本番）を切り替えることができます。

環境の作成

1. サイドバーの Environments タブをクリックします
2. + をクリックして新しい環境を作成します
3. 変数を追加します。

変数名	初期値	現在の値
base_url	https://api-dev.example.com	https://api-dev.example.com
api_key	dev-key-123	dev-key-123
user_id	42	42

ステージごとに個別の環境を作成します。

• Development: https://localhost:3000
• Staging: https://api-staging.example.com
• Production: https://api.example.com

リクエストでの変数使用

二重中括弧を使用して変数を参照します。

URL: {{base_url}}/api/users/{{user_id}}
ヘッダー: Authorization: Bearer {{api_key}}

変数のスコープ

Postmanの変数には階層があります（優先度の高い順）。

スコープ	表示範囲	ユースケース
Local	現在のリクエスト	一時的な上書き
Data	コレクション実行	反復（イテレーション）固有の値
Environment	選択された環境	ステージ固有の設定
Collection	コレクション全体	コレクション内のリクエスト間で共有
Global	すべてのワークスペース	稀に使用（機密情報には非推奨）

動的変数

Postmanは組み込みの動的変数を提供しています。

{{$randomFirstName}}    → "John"
{{$randomEmail}}        → "john@example.com"
{{$randomUUID}}         → "550e8400-e29b-41d4-a716-446655440000"
{{$timestamp}}          → 1738857600
{{$isoTimestamp}}       → "2026-02-06T12:00:00.000Z"

認証 (Authentication)

Postmanは複数の認証方法をサポートしています。Authorization タブで設定します。

Bearer Token

Type: Bearer Token
Token: {{access_token}}

API Key

Type: API Key
Key: X-API-Key
Value: {{api_key}}
Add to: Header

OAuth 2.0

1. Type に OAuth 2.0 を選択します
2. Get New Access Token をクリックします
3. OAuthの設定を入力します。

フィールド	値
Grant Type	Authorization Code
Auth URL	https://auth.example.com/authorize
Access Token URL	https://auth.example.com/token
Client ID	your-client-id
Client Secret	your-client-secret
Scope	read write

4. Request Token をクリックし、ブラウザで認証します
5. トークンが自動的にリクエストに追加されます

Basic Auth

Type: Basic Auth
Username: {{username}}
Password: {{password}}

テストの記述

Postmanには強力なテストスクリプトエンジンが搭載されています。Scripts > Post-response タブに JavaScript でテストを記述します。

基本的なステータスコードテスト

pm.test("ステータスコードが200であること", function () {
    pm.response.to.have.status(200);
});

レスポンスボディのテスト

pm.test("レスポンスの構造が正しいこと", function () {
    const json = pm.response.json();

    pm.expect(json).to.be.an("array");
    pm.expect(json.length).to.be.greaterThan(0);

    // 最初の項目の構造を確認
    pm.expect(json[0]).to.have.property("id");
    pm.expect(json[0]).to.have.property("name");
    pm.expect(json[0]).to.have.property("email");
});

レスポンスタイムのテスト

pm.test("レスポンスタイムが500ms未満であること", function () {
    pm.expect(pm.response.responseTime).to.be.below(500);
});

ヘッダーのテスト

pm.test("Content-TypeがJSONであること", function () {
    pm.response.to.have.header("Content-Type", "application/json; charset=utf-8");
});

変数によるリクエストの連鎖

一つのレスポンスから値を抽出し、次のリクエストで使用します。

// Loginリクエストのpost-responseスクリプトにて
pm.test("アクセストークンを保存", function () {
    const json = pm.response.json();
    pm.collectionVariables.set("access_token", json.token);
    pm.collectionVariables.set("user_id", json.user.id);
});

これで、以降のリクエストで {{access_token}} や {{user_id}} を使用できるようになります。

一般的なテストパターン

テスト内容	コード
ステータスコード	pm.response.to.have.status(200)
JSONプロパティの存在	pm.expect(json).to.have.property("id")
値の一致	pm.expect(json.name).to.eql("John")
配列の長さ	pm.expect(json.items.length).to.eql(10)
型チェック	pm.expect(json.id).to.be.a("number")
レスポンスタイム	pm.expect(pm.response.responseTime).to.be.below(500)
ヘッダーの存在	pm.response.to.have.header("X-Request-Id")

プリリクエストスクリプト (Pre-request Scripts)

プリリクエストスクリプトは、リクエストが送信される前に実行されます。動的な値の設定に使用します。

// タイムスタンプの生成
pm.collectionVariables.set("timestamp", Date.now().toString());

// ランダムなメールアドレスの生成
const email = `user_${Date.now()}@test.com`;
pm.collectionVariables.set("test_email", email);

// API認証用のHMAC署名の計算
const CryptoJS = require("crypto-js");
const secret = pm.collectionVariables.get("api_secret");
const body = pm.request.body.raw;
const signature = CryptoJS.HmacSHA256(body, secret).toString();
pm.collectionVariables.set("signature", signature);

モックサーバー (Mock Servers)

モックサーバーは、実際のバックエンドなしでAPIレスポンスをシミュレートします。フロントエンド開発やテストに有用です。

モックの作成

1. コレクションを右クリックします
2. Mock Collection を選択します
3. モックに名前を付けて Create をクリックします
4. モックURLをコピーします (例: https://abc123.mock.pstmn.io)

モックレスポンスの追加

コレクション内の各リクエストに対して、例（Example）となるレスポンスを追加します。

1. リクエストを開きます
2. Add Example をクリックします
3. レスポンスステータス、ヘッダー、ボディを設定します
4. 保存します

一致するリクエストが行われると、モックサーバーはこの例のレスポンスを返します。

Newman: CLI ランナー

Newman は Postman のコマンドライン用コレクションランナーです。CI/CD への統合に使用します。

インストール

npm install -g newman

コレクションの実行

# エクスポートされたファイルから実行
newman run my-collection.json -e staging-env.json

# Postman URLから実行
newman run https://api.getpostman.com/collections/YOUR_COLLECTION_ID?apikey=YOUR_API_KEY

CI/CD への統合

# GitHub Actions の例
name: API Tests
on: [push]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
      - run: npm install -g newman
      - run: newman run tests/api-collection.json -e tests/staging.json --reporters cli,junit --reporter-junit-export results.xml

Newman オプション

フラグ	説明
-e	環境設定ファイル
-g	グローバル変数ファイル
-n	反復回数
--delay-request	リクエスト間の遅延 (ms)
--timeout	リクエストのタイムアウト (ms)
--reporters	出力フォーマット (cli, json, junit, html)
--bail	最初の失敗で停止

ヒントとコツ

キーボードショートカット

ショートカット	アクション
Cmd+Enter	リクエスト送信
Cmd+S	リクエスト保存
Cmd+N	新規リクエスト
Cmd+Shift+S	名前を付けて保存
Cmd+/	スクリプトのコメント切り替え
Cmd+B	サイドバーの表示切り替え

コンソールによるデバッグ

Postman Console (Cmd+Alt+C) を開くと、リクエスト/レスポンスの詳細や、スクリプト内の console.log() 出力を確認できます。

// プリリクエストまたはテストスクリプトでのデバッグ
console.log("Request URL:", pm.request.url.toString());
console.log("Response body:", pm.response.json());

インポート/エクスポート

• Import: OpenAPI 3.x, Swagger 2.0, cURL, RAML, GraphQL, HAR フォーマットをサポートしています。
• Export: コレクションと環境は JSON v2.1 フォーマットとしてエクスポートされます。

結論

Postmanは、2026年においても包括的なAPI開発プラットフォームであり続けています。基本的なリクエストテストから、Newmanを使用した複雑な自動ワークフローまで、APIライフサイクル全体をカバーしています。コレクション、環境、テストスクリプト、そしてランナーをマスターすることで、生産性は飛躍的に向上するでしょう。

画像生成、ビデオ合成、テキスト読み上げなどのAIメディア生成を含むAPIを構築またはテストしている場合は、Hypereal AI が Postman で簡単にテストできる、ドキュメントの整った REST API を提供しています。Hypereal API コレクションをインポートして、今すぐアプリケーションへのAIメディア統合を始めましょう。