基本概念
この4つの設計さえつかめば、以降のプロトコルもシナリオもすべて簡単です:
- 3つのエンティティのモデル:グループ / 環境 / リクエストの関係
- 環境Pre-URLの設計:リクエストが相対パスしか保存しない理由
- 送信アセンブルパイプライン:1回の「送信」が設定をどのように実際のリクエストに変えるか
- 変数システム:
{{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 |
|---|---|---|
| HTTP | http:// | https:// |
| WebSocket | ws:// | wss:// |
| TCP | tcp:// | tcps:// |
| UDP | udp:// | — |
| gRPC | grpc:// | grpcs:// |
| MQTT | mqtt:// | mqtts:// |
⚠️ よくある間違い:WebSocketのベースアドレスは
ws:///wss://と書く必要があります。https://と入力するとHTTPとして扱われ、WebSocketリクエストはベースアドレスが見つからず失敗します。プロトコル行とschemeを一致させてください。
送信アセンブルパイプライン
「送信」をタップしてもソケットが直接飛ぶわけではありません。パイプラインは「リクエスト + グループの環境 + 変数」を段階的に組み立てて実際のリクエストにし、ネットワーク呼び出しの前後にアクションチェーンを挿入します:
要点:
- アクションチェーンは「スクリプトを実行」が有効なときだけ動きます。アプリで送信をタップすればデフォルトで実行されますが、自動化 / MCP送信では明示的に有効化が必要です。スクリプト無効なら、送信前に注入されるはずのトークンも暗号化も行われません — これこそ recipes の「トークンなし → 401」の否定検証がその挙動を示す理由です。
- 送信前スクリプトは出ていくリクエストを書き換え、レスポンス後スクリプトは受け取ったレスポンスを書き換えます。 どちらも実行時変数を読み書きできます。