カスタムAPIアクション

Slack APIに対してカスタムの認証済みHTTP呼び出しを行います。

注

このアクションは他のSlackカードと異なります。Slack APIのドキュメントを参照してください。

オプション

フィールド定義タイプ必須
Request Type(リクエストタイプ) ドロップダウンTRUE
GET パラメーターに基づいてWebサーバーからデータを取得します。このメソッドは指定されたリソースの表現を要求します。リクエストが成功した場合、要求したコンテンツとともに200 (OK)レスポンスメッセージを受信します。
POSTパラメーターに基づいてWebサーバーにデータを送信します (たとえば、ファイルのアップロードなど)。複数のPOSTリクエストは1つのPOSTと異なる結果になる場合があるため、意図せずに複数のPOSTリクエストを送信することについて注意が必要です。リクエストが成功した場合、200 (OK)レスポンスメッセージを受信します。
PUTパラメーターに基づいてWebサーバーの特定の場所に格納されるデータを送信します (たとえば、ファイルのアップロードなど)。PUTおよびPOSTリクエストの違いはPUTが冪等であるということです。つまり、リクエストが成功する場合、単一のPUTリクエストの結果は同一のPUTリクエストを何回行っても同じです。リクエストが成功した場合、200 (OK)201 (Created)、または204 (No Content)レスポンスメッセージを受信します。
PATCHパラメーターに基づいてWebサーバー上のリソースに部分的な変更を適用します。PATCHは冪等ではありません。つまり、複数のPATCHリクエストによって意図しない結果が生じる可能性があります。PATCHが成功した場合、200 (OK)または204 (No Content)レスポンスメッセージを受信します。
DELETEパラメーターに基づいてWebサーバーから特定のリソースを削除します (リソースが存在する場合)。DELETEが成功した場合、200 (OK)レスポンスメッセージを受信します。

入力

フィールド定義タイプ必須
Relative URL (相対URL) 対話を試みるWebサーバーのアドレス。Relative URLは、URLの先頭でプロトコルを明示する必要がないことを意味します (たとえば「http://」など)。これにより、操作は(このインスタンスの)サーバー上で発生することがWebサーバーに示されます。

例:https://api.slack.com/scim{{input.Request.Relative URL}}

注意

Slack Adminコネクターがクエリを実行できるのはSlack内のSCIMエンドポイントだけであり、Slack内の他の管理APIでは使用できません。このようなユースケースではSlackコネクターを使用してください。

文字列FALSE
Query (クエリー)URLで実行されるアクションを定めるJSONオブジェクト。オブジェクトまたは文字列FALSE
Headers (ヘッダー)リクエストのコンテンツタイプを定めるJSONオブジェクト。これは通常、以下の例の複製です。オブジェクトFALSE

出力

フィールド定義タイプ
Status Code(ステータスコード)操作の結果。HTTPステータスコードはコネクタによって返され、カードによって実行されたアクションが成功したか失敗したかを示します。以下に例を挙げます。
  • 201 Createdステータスコードは、新しいリソースが作成された場合の成功を示します。
  • 403 Forbiddenエラーは、必要な権限が不足していたためにHTTPリクエストが処理されなかったことを示します。

発生する可能性があるステータスコードの完全なリストについては、「 HTTPステータスコード」を参照してください。

数値
Headers (ヘッダー)出力ボディーとは関係のない、ステータスコードの詳細なコンテキスト。レスポンスヘッダーは選択されたHTTPリクエストオプションに依存します。すべてのヘッダーがレスポンスヘッダーではないことに注意してください。これは通常、以下の例の複製です。オブジェクト
Body (ボディー)選択されたHTTPリクエストから返されるデータ (たとえば、GETリクエストからのデータなど)。オブジェクト

関連項目

Slack Adminコネクタ

Okta Workflowsの要素について

管理者用アプリ