Echolotショートカット
ショートカットアプリ、Siri、オートメーションから保存済みのリクエストやフォルダを実行し、その結果を次のアクションで使います。
Echolotは、ショートカットアプリにリクエストを実行とフォルダを実行の2つのアクションを追加します。 どちらも、ランナーと同じように、保存済みのリクエストをチェックとともに送信し、結果を次のアクションに渡します。 毎朝のAPIの確認、キーボードショートカットからの確認、Siriへの依頼などに使えます。実行中も、Echolotは前面に出てきません。
アクション
ショートカットアプリでEcholotを検索し、リクエストの下から見つけます。
リクエストを実行
ワークスペースの保存済みのリクエストを1件、チェックとともに送信し、結果を返します。 エディタでは「ワークスペース」の「リクエスト」を実行と表示されます。
| パラメータ | 選択する内容 |
|---|---|
| ワークスペース | Echolotで開いているワークスペース、または最近使ったワークスペース。 |
| リクエスト | そのワークスペースの保存済みのリクエスト。メソッドとパスが表示されます。 |
| 環境 | 省略可能。ワークスペースに表示される環境の名前、またはそのスラッグ。空の場合は、ワークスペースがそのウインドウで使っている環境、または最後に使った環境。 |
フォルダを実行
フォルダ内のすべてのリクエストを、チェックとともに順番に実行し、結果を返します。 エディタでは「ワークスペース」の「フォルダ」を実行と表示されます。
| パラメータ | 選択する内容 |
|---|---|
| ワークスペース | Echolotで開いているワークスペース、または最近使ったワークスペース。 |
| フォルダ | そのワークスペースのフォルダ、またはすべてのリクエストを対象にするワークスペース全体（名前）。 |
| 環境 | 省略可能。「リクエストを実行」と同じです。 |
リクエストはスクリプトとチェックとともに実行され、レスポンスは、ワークスペースのウインドウから送信した場合と同じように、ワークスペースの履歴に記録されます。 ワークスペースを開いておく必要はありません。
Mac App Store版
アクションは、App Storeエディションでも同じように動作します。開いていないワークスペースには、ワークスペースを開いたときにEcholotに与えたアクセス権を通じてアクセスします。
エディションを比較実行結果
どちらのアクションも、次のアクションに渡す実行結果を返し、ショートカットの終了時にその概要を表示します。
| プロパティ | 内容 |
|---|---|
| 成功 | すべてのリクエストがエラーなく実行され、すべてのチェックが成功したかどうか（スキップされたチェックは失敗として数えません）。 |
| リクエスト | 実行されたリクエストの数。 |
| 失敗したリクエスト | 失敗したリクエストの数。 |
| ステータス | ステータスコード（リクエスト1件の場合）。 |
| 所要時間（ms） | ミリ秒単位の時間（リクエスト1件の場合）。 |
| 概要 | 1行の文。リクエスト1件ならGET List products: 200 in 182 ms, 3 of 3 checks passed、フォルダなら2 of 9 requests failedのようになります。 |
| 失敗 | 失敗したリクエストごとに1行。リクエストの名前と、エラーまたは失敗したチェック。 |
保護された環境
環境が保護されている場合、ショートカットは何かを送信する前に、環境と送信される内容を示して確認します。 拒否すると、何も送信せずにアクションが終了します。
Siri
Echolotのアクションは、ショートカットを設定しなくてもSiriで使えます。 「Echolotでリクエストを実行」や「Echolotでリクエストを送信」と言うと「リクエストを実行」が、「Echolotでフォルダを実行」や「Echolotでフォルダのリクエストを実行」と言うと「フォルダを実行」が動作します。
例：毎朝ショップを確認する
デモAPIに対して動作するAlpenglowの例のワークスペースを使います。
ショートカットアプリで新規ショートカットを作成し、フォルダを実行を追加します。AlpenglowワークスペースとCatalogフォルダを選択します。
条件分岐を追加し、入力に実行結果の成功、条件に偽であるを指定します。
条件分岐の中に通知を表示を追加し、実行結果の概要を指定します。失敗したリクエストをすべて表示するには失敗を指定します。
オートメーションで、このショートカットを毎朝実行するパーソナルオートメーションを作成します。