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

クイックスタート · 3ステップで最初のリクエスト

目標:ゼロから動くHTTPリクエストを組み立てます。「グループ → 環境 → リクエスト」の主線さえつかめば、他のプロトコルは「別のプロトコル + 別のPre-URL」であるだけです。


ステップ1:グループを作成し、環境をバインド​

Quick Requestでは環境はグループにバインドされ、グループ内の全リクエストが共有します。

  1. 新しいグループを作成します(例:最初のグループ)。
  2. グループに環境をバインドします。まだなければ、先に環境を作成します(例:Local)。

なぜこの1層を挟むのか? モジュールが dev / staging / production を移動するとき、編集したいのは環境1つであって、数十のリクエストではないからです。


ステップ2:環境にPre-URLを入力​

環境はプロトコルごとに1つのベースアドレスを保持します。HTTPを送るには http 行を入力します:

プロトコル行ベースアドレスの例備考
HTTPhttp://127.0.0.1:18080https:// でTLS有効化
WebSocketws://127.0.0.1:18085wss:// でTLS有効化
gRPCgrpc://127.0.0.1:18089grpcs:// でTLS有効化
MQTTmqtt://127.0.0.1:18884mqtts:// でTLS有効化

⚠️ 最も起きやすい落とし穴:ベースアドレスがどのプロトコルに属するかは、URL先頭のschemeで決まり、入力した行では決まりません。WebSocketのベースアドレスは ws://… か wss://… と書く必要があります。誤って https://… と入力するとHTTPとして扱われ、WebSocketリクエストはベースアドレスを見つけられず失敗します。プロトコル行とschemeを一致させてください。

(上記の 18080 などのポートはサンプルテストサーバーのものです。自分のAPIを試すときは実際のアドレスに置き換えてください。)


ステップ3:リクエストを作成し、パス断片だけ入力して送信​

グループ内にリクエストを作成します:

  1. プロトコル:HTTP;メソッド:GET。
  2. URL — パス断片だけ入力:/echo(完全なホストは不要 — ホストは環境の http Pre-URLがすでに供給します)。
  3. 送信をタップします。

/echo が送った内容をそのまま返すのが見えます。実際にワイヤーに流れたのは http://127.0.0.1:18080/echo です。


動いた — 次は?​

  • 「なぜ /echo だけでいいのか」「{{x}} はどこから来るのか」を理解する → concepts
  • 送信前に署名 / レスポンスを復号する → スクリプト
  • 「ログインでトークン取得、グループ全体に自動付与」のレシピをコピーする → recipes
  • プロトコルを変える(WS/TCP/UDP/gRPC/MQTT) → 対応するプロトコルページ(インデックス 参照)