メインコンテンツまでスキップ

基本概念

この4つの設計さえつかめば、以降のプロトコルもシナリオもすべて簡単です:

  1. 3つのエンティティのモデル:グループ / 環境 / リクエストの関係
  2. 環境Pre-URLの設計:リクエストが相対パスしか保存しない理由
  3. 送信アセンブルパイプライン:1回の「送信」が設定をどのように実際のリクエストに変えるか
  4. 変数システム:{{variable}} はどこから解決され、3つの変数レイヤーとは

3つのエンティティのモデル​

なぜ環境はリクエストごとではなくグループにバインドされるのか? グループは通常「1つのデプロイ先における1モジュールの全API」を表します。グループ単位でのバインドは、環境の切り替えがグループ全体を一括で移動させることを意味します — リクエストごとの編集は不要です。単一のリクエストだけ別の環境が必要な場合は、その環境にバインドされたグループに置けばOKです。


環境Pre-URLの設計​

これは最も重要な — そして最も誤解されやすい — 設計です。

リクエストは相対パスのみ保存、環境はベースアドレスを保存​

従来のツールではすべてのリクエストが完全なURL(https://api.example.com/v1/users)を保存するため、テスト環境への切り替えはドメインの一括置換を意味します。このツールはそれを逆転させます:

schemeがプロトコルとTLSを決める(重要!)​

Pre-URLはプロトコルごとに保存されますが、あるエントリが実際に対応するプロトコルはURL先頭のschemeで決まります。schemeは「どのプロトコルか」と「暗号化するか(TLS)」の両方を表します:

プロトコル平文のscheme暗号化のscheme
HTTPhttp://https://
WebSocketws://wss://
TCPtcp://tcps://
UDPudp://—
gRPCgrpc://grpcs://
MQTTmqtt://mqtts://

⚠️ よくある間違い:WebSocketのベースアドレスは ws:// / wss:// と書く必要があります。https:// と入力するとHTTPとして扱われ、WebSocketリクエストはベースアドレスが見つからず失敗します。プロトコル行とschemeを一致させてください。


送信アセンブルパイプライン​

「送信」をタップしてもソケットが直接飛ぶわけではありません。パイプラインは「リクエスト + グループの環境 + 変数」を段階的に組み立てて実際のリクエストにし、ネットワーク呼び出しの前後にアクションチェーンを挿入します:

要点:

  • アクションチェーンは「スクリプトを実行」が有効なときだけ動きます。アプリで送信をタップすればデフォルトで実行されますが、自動化 / MCP送信では明示的に有効化が必要です。スクリプト無効なら、送信前に注入されるはずのトークンも暗号化も行われません — これこそ recipes の「トークンなし → 401」の否定検証がその挙動を示す理由です。
  • 送信前スクリプトは出ていくリクエストを書き換え、レスポンス後スクリプトは受け取ったレスポンスを書き換えます。 どちらも実行時変数を読み書きできます。

変数システム​

スコープの異なる3種類の「変数」があります。この混同が初心者に最も多い落とし穴です。

{{name}} は実際に何を解決できる?​

どこに書くか環境変数実行時変数典型的な用途
{{name}}(URL / params / headers / body内)✅❌環境設定の参照、動的な値の埋め込み
スクリプト内での変数読み取り✅✅ログイントークンのリクエスト間受け渡しなど

覚え方:{{}} が見るのは「設定系」の変数だけ。スクリプトは3層すべて読めます。 実行時変数は「ランタイムの黒板」— そこに書けるのはスクリプトだけで、{{}} は決してそこを見ません。

なぜ {{authToken}} はログイン時に保存したトークンを読めないのか? ログインスクリプトが実行時レイヤーに保存したもので、{{}} はそれを解釈しないからです。正しいのは、それを読んでヘッダーに注入する送信前スクリプトです(recipes、シナリオ1 参照)。

動的変数 {{$xxx}}​

{{}} には組み込みの動的変数セットもあり、評価のたびに新しく生成され、URL / params / headers / body で直接使えます:

変数生成するもの
{{$timestamp}} / {{$timestampMs}}Unixタイムスタンプ(秒 / ミリ秒)
{{$isoTimestamp}}ISO8601 UTC
{{$uuid}} / {{$guid}}UUID v4
{{$randomInt}} / {{$randomInt min,max}}ランダム整数(デフォルト0..1000)
{{$randomBoolean}} {{$randomFullName}} {{$randomEmail}} {{$randomPhoneNumber}} {{$randomIpv4}} {{$randomIpv6}} {{$randomUrl}} {{$randomColor}} {{$randomHexadecimal}} {{$randomAlphaNumeric}} {{$randomCity}} {{$randomCountry}} {{$randomDateRecent}} {{$randomPrice}} {{$randomWord}} {{$randomLorem}} {{$randomCompanyName}} など各種ランダムサンプルデータ

例:GET /echo?ts={{$timestamp}}&u={{$uuid}} — 実際には毎回の送信で ts/u が新しい実値に置き換わります。


まとめ​

  • リクエストはパス断片だけ保存し、環境がPre-URLでプロトコルごとのベースアドレスを供給し、schemeがプロトコル + TLSを決めます。
  • 送信はアセンブルパイプラインです:URL結合 → 補間 → トランスポート設定 → 送信前チェーン → ネットワーク → レスポンス後チェーン。
  • 変数は3層:{{}} は設定系変数を読み、スクリプトは3層すべて読めます。トークンの受け渡しは {{}} ではなくスクリプトで行います。

次:スクリプト →