メインコンテンツへスキップ
GET
人間の入力フォームを取得

承認

Authorization
string
header
必須

すべてのリクエストは API キーで認証します:Authorization: Bearer {API_KEY}。アプリのエンドポイントにはアプリの API キーを、ナレッジのエンドポイントにはナレッジベースの API キーを使用します(Dify API クイックスタート)。

キーはサーバーサイドで保管し、クライアントコードには決して埋め込まないでください。キーが欠落または無効なリクエストは HTTP 401unauthorized)で失敗します。

パスパラメータ

form_token
string
必須

一時停止中のフォームへのアクセストークン。ストリーミングモードのワークフローを実行エンドポイントまたはチャットメッセージを送信エンドポイントが返す human_input_required イベントから取得します。

レスポンス

フォーム内容の取得に成功しました。

form_content
string

ワークフロー変数を埋め込んだ、事前レンダリング済みのフォーム本文。

inputs
object[]

フォーム入力フィールドの定義。

resolved_default_values
object

フォームに表示するための事前計算済みデフォルト値。入力の output_variable_name をキーとします。デフォルト値がワークフロー変数から解決可能な paragraph 入力にのみ設定されます。解決可能なデフォルトがない入力では空になります。クライアントはこれらの値をそのまま表示してください。 default をクライアント側で再解決する必要はありません。すべての値は文字列化されています。

user_actions
object[]

利用可能な送信アクション。

expiration_time
integer<int64> | null

Unix タイムスタンプ(秒)。この時刻以降、フォームは送信できなくなります。