メインコンテンツへスキップ
POST
人間の入力フォームを送信

承認

Authorization
string
header
必須

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

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

パスパラメータ

form_token
string
必須

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

ボディ

application/json
inputs
object
必須

各入力の output_variable_name をキーとして送信する値。各値は文字列です。

action
string
必須

受信者が選択したアクションボタンの ID。フォームの user_actions リスト(人間の入力フォームを取得 エンドポイントから返される)にある id のいずれかと一致する必要があります。

user
string
必須

エンドユーザーの識別子。アプリ側で定義し、アプリ内で一意にします。サービス API と WebApp のユーザー ID は、たとえ同じでも別物として扱われます。エンドユーザーの識別 を参照してください。

レスポンス

フォームの送信に成功しました。レスポンスボディは空のオブジェクトです。

The response is of type object.