こんにちは。API開発の最前線で戦っている皆さん、日々の開発で「あ、また本番環境のURLにテストデータを送っちゃった…！」と冷や汗をかいた経験はありませんか？
あるいは、環境が変わるたびにソースコードやコレクション内のURLを書き換えていませんか？
もしそうなら、今日でその「非効率で危険な習慣」とはおさらばしましょう。世界中のトップエンジニアが愛用するPostmanの「環境変数（Environment）」。これをマスターすれば、あなたの開発効率は劇的に向上し、何より「誤操作による事故」を未然に防ぐ堅牢なテスト環境が手に入ります。
今日は、Postmanをただの「API叩きツール」から「プロフェッショナルな開発基盤」へと進化させる極意を伝授します。
—
1. なぜ「ハードコーディング」は悪なのか？
APIテストにおいて、`https://api.myapp.com/v1/users` といったエンドポイントをそのままリクエスト欄に直打ちすることを「ハードコーディング」と呼びます。
これには以下のリスクが伴います。
- 環境切替のコスト: 開発(Dev)、検証(Staging)、本番(Prod)と切り替えるたびにURLを書き換えるのは時間の無駄です。
- ヒューマンエラー: 疲れている時に本番環境へテストデータを流し込むリスクはゼロではありません。
- 機密情報の露出: トークンをリクエストに直接書くと、Git管理などで誤って漏洩する危険があります。
環境変数は、これらを「変数」という抽象化された箱に入れることで、安全かつ瞬時に切り替え可能にする仕組みです。
—
2. 環境変数のセットアップ：まずは「箱」を作る
まずは、Postmanの右上のアイコンから環境変数を作成しましょう。
1. Postman右上の「Environment quick look」（目のアイコン）をクリック。
2. 「Add」ボタンを押して、新しい環境（例: `Development`）を作成。
3. 以下の変数を定義します。
- `base_url`: `https://dev-api.example.com`
- `api_key`: `dev_secret_key_12345`
これだけで、`https://dev-api.example.com` という文字列は、`{{base_url}}` という変数名に置き換わりました。
—
3. HelloWorld的実装：変数を呼び出す
さあ、実際にリクエストを作ってみましょう。
1. 新しいリクエストを開きます。
2. URL欄にこう入力してください：`{{base_url}}/v1/users`
3. 画面右上のドロップダウンから作成した `Development` を選択。
4. 「Send」ボタンをポチッ！
ポイント: URL欄の `{{base_url}}` にマウスカーソルを合わせると、現在設定されている値がポップアップで表示されます。これが正しく表示されていれば、あなたの設定は完璧です。
—
4. 【極意】APIトークンの動的差し替え
API開発において最も重要なのは「認証」です。Postmanの「Pre-request Script」を使うと、リクエストを送る直前にトークンを自動取得・セットすることができます。
以下のコードを、コレクションの「Pre-request Script」タブに貼り付けてみてください。
// 環境変数からクライアントIDとシークレットを取得
const clientId = pm.environment.get(“client_id”);
const secret = pm.environment.get(“client_secret”);
// 認証エンドポイントへトークンを要求する模擬ロジック
pm.sendRequest({
url: pm.environment.get(“auth_url”),
method: ‘POST’,
header: { ‘Content-Type’: ‘application/json’ },
body: {
mode: ‘raw’,
raw: JSON.stringify({ client_id: clientId, client_secret: secret })
}
}, (err, res) => {
// 取得したトークンを環境変数「access_token」に保存する
const jsonData = res.json();
pm.environment.set(“access_token”, jsonData.token);
});
これで、毎回手動でトークンをコピペする必要はありません。「環境を選ぶだけで、認証もURLもすべて自動で切り替わる」。これがプロの環境構築です。
—
5. 安全に運用するための「黄金律」
最後に、現場で生き残るための鉄則を3つお伝えします。
1. 環境を色で区別する:
Postmanの環境設定で、本番環境(Prod)は「赤」、開発環境(Dev)は「青」など、色を付けておきましょう。リクエストを送る直前に視覚的に分かるようにするのが、事故を防ぐ最大の防御です。
2. 機密情報は「Initial Value」に保存しない:
環境変数には「Initial Value（共有される値）」と「Current Value（自分だけが見る値）」があります。パスワードや本番APIキーは、必ず Current Value にのみ入力し、Postman Cloudに同期されないように徹底してください。
3. 変数は「意味のある名前」で:
`url1`, `url2` ではなく `base_url`, `auth_base_url` と、誰が見ても役割がわかる名前にしましょう。
—
まとめ
Postmanの環境変数は、単なる「置換ツール」ではありません。それは、「環境の差異を意識せず、ロジックだけに集中するための結界」です。
これを使いこなせば、あなたは環境依存のバグや設定ミスに悩まされることなく、本来やるべき「価値あるAPI開発」に全力を注げるようになります。
さあ、まずは今のプロジェクトのURLを `{{base_url}}` に変えるところから始めてみてください。あなたのAPI開発ライフが、今日から劇的にクリアになりますよ。応援しています！