Postman ユーザーマニュアル:完全ガイド (2026年版)
Postman を使用した API 開発に関する、知っておくべきすべてのこと
Hyperealで構築を始めよう
Kling、Flux、Sora、Veoなどに単一のAPIでアクセス。無料クレジットで開始、数百万規模まで拡張可能。
クレジットカード不要 • 10万人以上の開発者 • エンタープライズ対応
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 リクエスト
- + タブをクリックして新しいリクエストを開きます
- メソッドのドロップダウンから GET を選択します
- URLを入力します:
https://jsonplaceholder.typicode.com/users - 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 リクエストの送信
- メソッドとして POST を選択します
- URLを入力します:
https://jsonplaceholder.typicode.com/posts - Body タブに移動します
- raw を選択し、ドロップダウンから JSON を選択します
- ボディを入力します:
{
"title": "My Post",
"body": "This is the content of my post.",
"userId": 1
}
- 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で効率的に作業するための基盤となります。
コレクションの作成
- 左サイドバーの Collections をクリックします
- + または New Collection をクリックします
- 名前を入力します (例: "User Management API")
- 説明を追加します (任意ですが推奨されます)
コレクションへのリクエスト追加
コレクションを右クリックし、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 は、コレクション内のすべてのリクエストを順番に実行します。
- コレクションの Run をクリックします
- 反復回数 (iterations)、遅延 (delay)、データファイルを構成します
- Run Collection をクリックします
これは統合テストやデータシーディング(初期データの投入)に非常に強力です。
環境 (Environments) と変数 (Variables)
環境を使用すると、リクエストを変更することなく、異なるAPI設定(開発、ステージング、本番)を切り替えることができます。
環境の作成
- サイドバーの Environments タブをクリックします
- + をクリックして新しい環境を作成します
- 変数を追加します。
| 変数名 | 初期値 | 現在の値 |
|---|---|---|
| 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
- Type に OAuth 2.0 を選択します
- Get New Access Token をクリックします
- 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 |
- Request Token をクリックし、ブラウザで認証します
- トークンが自動的にリクエストに追加されます
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レスポンスをシミュレートします。フロントエンド開発やテストに有用です。
モックの作成
- コレクションを右クリックします
- Mock Collection を選択します
- モックに名前を付けて Create をクリックします
- モックURLをコピーします (例:
https://abc123.mock.pstmn.io)
モックレスポンスの追加
コレクション内の各リクエストに対して、例(Example)となるレスポンスを追加します。
- リクエストを開きます
- Add Example をクリックします
- レスポンスステータス、ヘッダー、ボディを設定します
- 保存します
一致するリクエストが行われると、モックサーバーはこの例のレスポンスを返します。
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メディア統合を始めましょう。
