Echolot動的な値
タイムスタンプ、UUID、ハッシュ、エンコード、ファイル、ほかのリクエストやそのレスポンスの値など、送信時に求められる値をリクエストに埋め込みます。
動的な値は、リクエストを送信するたびにEcholotが求めるトークンです。現在の時刻、新しいUUID、ボディの署名、ほかのリクエストの最新のレスポンスの値などがあります。
変数と同じように書きますが、先頭に$が付きます：{{$uuid}}、{{$sha256('{{password}}')}}。動的な値は、変数が使える場所ならどこでも使えます。
URL、パラメータ、ヘッダー、ボディ、フォームのフィールド、認証のフィールドです。
このページでは、動的な値の追加と編集の方法を説明します。すべての動的な値と引数は、動的な値のリファレンスにあります。
リストから追加する
- 変数を受け付けるフィールドで
{{と入力します。リストが開き、スコープ内の変数が先に、続いて動的な値がカテゴリごとに表示されます。 - 続けて入力すると絞り込めます：
uuid、time、hmac。各項目には、何が得られるかが書かれています。 - ↑と↓で移動し、↩または⇥で挿入します。Escでリストを閉じます。
引数を取る値は、挿入するとすぐにエディタが開くので、引数を入力する代わりにフォームで入力できます。{{を入力せずにリストを開くには、フィールドを右クリックして変数または値を挿入…を選びます。
フィールド内では、動的な値は読みやすいラベル付きのピルとして表示されます。値のタイトル（HMAC-SHA256）、レスポンスの値なら、リクエストと読み取る内容（Sign in › $.access_token）です。
その下のテキストは、書いたままです。
トークンを編集する
ピルをダブルクリックするか、右クリックしてトークンを編集…を選びます。トークンエディタが開きます：
- 上部のボタンは、トークンが何であるかを示し、切り替えもできます。変数か動的な値かです。
- フィールドは値の引数です。リクエストの引数は、ワークスペースのリクエストをフォルダごとにまとめたメニューです。クエリの引数（JSONPath、XPath、ヘッダー名）には、 最新のレスポンスにあるものを一覧するボタンが付いているので、パスを入力する代わりに値を選べます。
- 値は、現在の環境でトークンが何を返すかを表示します。解決できないときは現在の環境では解決できませんと、その理由が表示されます。
- 変数では、別の変数を使用で別の変数に差し替えられ、代わりにレスポンスの値を使用でレスポンスの値に変えられます。
- 削除でトークンを削除し、完了で変更を確定します。
クイックルック
ピルにポインタを合わせると、開かなくてもその値が分かります。値（シークレットはマスクされ、シークレットと表示）、取得元、書き方です。 動的な値では、いつ求められるかも表示されます。時間やランダムの値は、送信のたびに作り直されます。上は例です。 ボタンは編集…、値をコピー、すべての変数…で、最後のものは変数パネルを開きます。
手で書く
{{$name}} no arguments
{{$name('text', 42)}} text in single or double quotes, numbers as they are
{{$base64(user)}} a bare name is a variable
{{$base64('{{user}}:{{pass}}')}} variables inside text
{{$sha256("{{$requestBody('')}}")}} a dynamic value inside another one引用符で囲んだ引数の中のトークンは、自分の引数に別の種類の引用符を使う必要があります。最後の行のように、引数を単一引用符で書いたトークンは、二重引用符で囲みます。
使えるもの
| カテゴリ | 例 | 得られるもの |
|---|---|---|
| レスポンス | {{$response('auth/sign-in', '$.access_token')}}、{{$responseHeader('orders/create-order', 'Location')}}、{{$responseStatus('auth/sign-in')}} | ほかのリクエストの最新のレスポンスの値。 |
| リクエスト | {{$requestHeader('', 'Content-Type')}}、{{$requestURL('auth/sign-in')}}、{{$requestJSONPath('', '$.lines[0].sku')}} | このリクエスト（最初の引数が空）またはほかのリクエストの、送信されるとおりの一部分。 |
| エンコーディング | {{$base64('heidi:alpenglow')}}、{{$urlEncode('a b&c')}}、{{$jsonEscape('say "hi"')}}、{{$basicAuth('heidi', '{{password}}')}}、{{$jwt('{"sub": "heidi"}', '{{jwtSecret}}')}}、{{$newline}} | エンコードまたはデコードしたテキスト、エスケープ、Basic認証の値、署名したJWT。 |
| ハッシュと署名 | {{$sha256("{{$requestBody('')}}")}}、{{$hmacSha256('{{key}}', 'message', 'base64')}}、{{$md5('text')}} | ハッシュとHMAC。base64またはbase64urlを指定しなければ16進数です。 |
| 時間 | {{$timestamp}}、{{$timestampMs}}、{{$isoTimestamp}}、{{$httpDate}}、{{$date('yyyy-MM-dd', -86400, 'Europe/Zurich')}} | 送信時刻。Unix秒またはミリ秒、ISO 8601、HTTP日付、独自の形式で、秒単位のオフセットとタイムゾーンを指定できます。 |
| ランダム | {{$uuid}}、{{$randomInt(1, 6)}}、{{$randomString(16)}}、{{$randomHex(8)}} | 送信のたびに新しいランダムな値。$guidと$randomUUIDは$uuidの別名です。 |
| ダミーデータ | {{$randomFullName}}、{{$randomEmail}}、{{$randomCity}}、{{$randomPrice}}、{{$randomLoremSentence}}、{{$randomDatePast}} | 架空の名前、住所、会社、価格、日付、ダミーテキストなど。送信のたびに新しくなり、名前はPostmanと同じです。リストではサブメニューにまとまっています。ダミーデータを参照してください。 |
| テキスト | {{$lowercase('{{name}}')}}、{{$uppercase('chf')}}、{{$trim('{{code}}')}} | 変換したテキスト。 |
| ファイルとシステム | {{$file('data/order.json')}}、{{$env('HOME')}} | ファイルの内容（ワークスペースからの相対パス、または絶対パス）、またはEcholotプロセスの環境変数。 |
$envはエージェントでは使えません。AIエージェントがリクエストを送信するとき、Macの環境変数はそこに入りません。
Alpenglowの例では、Orders › Create orderで使っています。Idempotency-Keyヘッダーが{{$uuid}}なので、注文のたびに新しい値になります。
ほかのリクエストのレスポンスの値
レスポンスの値は、保存されているほかのリクエストの最新のレスポンスを読み取ります。最初の引数は、そのリクエストのワークスペース内のパスで、ファイルと同じフォルダ名とリクエスト名です。
Auth › Sign inならauth/sign-inです。
| 値 | 読み取るもの |
|---|---|
$response(request, query) | クエリの形式で決まる任意のもの：$.token（JSONPath）、/feed/entry[1]/id（XPath）、header:Location、cookie:session、regex:token=(\w+)、jq:.data.token、keypath:data.items.0.id。 |
$responseJSONPath、$responseKeyPath、$responseJq、$responseXPath、$responseRegex | その種類のクエリでボディを読み取ります。正規表現は、グループがあれば最初のグループを返します。 |
$responseHeader、$responseCookie | ヘッダー、またはレスポンスが設定したCookie。 |
$responseStatus、$responseBody、$responseBodyLength | ステータスコード、テキストとしてのボディ、そのバイト数。 |
値が読み取るリクエストにまだレスポンスがないとき、Echolotはそのリクエストを先に送信します。URLバーの下の行に、送信前にそう表示されます：先に「Sign in」を送信。 省略可能な最後の引数が、いつ送信するかを決めます。トークンエディタでは先に送信です：
| 引数 | エディタでの表示 | 動作 |
|---|---|---|
（なし）または'if-missing' | まだレスポンスがないとき | 相手のリクエストにレスポンスがないときだけ、そのリクエストを送信します。 |
'fresh' | 毎回 | このリクエストを送信するたびに、先に相手を送信します（ランナーでは実行ごとに1回）。 |
'latest' | しない：最新のレスポンスを使用 | 送信せず、最新のレスポンスを使います。 |
{{$response('auth/sign-in', '$.access_token', 'fresh')}}リクエスト同士が循環して読み合っていると、該当するリクエスト名を示して拒否されます。
レスポンスの値を、1つのリクエストを指す代わりに、すべてのリクエストが読む変数に保存するには、レスポンスのキャプチャを使います。
このリクエストの値
リクエストの値は、変数と認証が埋められた、送信されるとおりのリクエストを読み取ります。送信中のリクエストなら、最初の引数を空にします：{{$requestHeader('', 'X-Request-Id')}}。
Echolotは求められた部分だけを計算するので、ヘッダーでボディに署名できます：
X-Signature: {{$hmacSha256('{{signingKey}}', "{{$requestBody('')}}")}}jq
jqフィルタは$responseJq、$requestJq、$response(…, 'jq:…')で使えます。インストールするものはありません。複数の結果を返すフィルタは、1行に1つずつ返します：
{{$responseJq('catalog/list-products', '.items[0].sku')}}
{{$responseJq('catalog/list-products', '[.items[].price.amount] | add')}}値が解決されないとき
求められないトークン（変数がない、レスポンスがなく送信もできないリクエスト、何も見つからないJSONPathなど）は、書いたままで送信され、URLバーの下の行に1件の問題と表示されます。 クリックすると内容が分かります。トークンエディタとクイックルックにも同じことが表示されます。