メインコンテンツへスキップ
GET
ワークフロー実行詳細を取得

承認

Authorization
string
header
必須

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

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

パスパラメータ

workflow_run_id
string
必須

ワークフロー実行 ID です。ワークフローを実行 のレスポンスまたはストリーミングイベント、あるいは Chatflow アプリのメッセージメタデータから取得します。

レスポンス

ワークフロー実行の詳細の取得に成功しました。

id
string<uuid>

ワークフロー実行 ID です。

workflow_id
string<uuid>

Workflow ID.

status
string

ワークフローの実行ステータスです。running は実行中、succeeded は正常完了、failed は実行エラー、stopped は手動停止、partial-succeeded は一部のノードが成功し他が失敗、paused は人間の入力待ちを示します。

inputs
string | null

ワークフロー実行の入力変数です。生の JSON 文字列として返されるため(例:{"query": "..."})、クライアント側でパースする必要があります。null の場合もあります。

outputs
object

ワークフローからの出力データです。出力がまだない場合は空のオブジェクトです。

error
string | null

ワークフローが失敗した場合のエラーメッセージです。

total_steps
integer

実行されたワークフローの合計ステップ数です。

total_tokens
integer

消費された合計トークン数です。

created_at
integer<int64>

ワークフロー実行が作成された Unix タイムスタンプです。

finished_at
integer<int64> | null

ワークフロー実行が完了した Unix タイムスタンプです。

elapsed_time
number<float> | null

合計経過時間(秒)です。