このページでは、REST API で DocFlow のファイルタスクを再試行する方法を説明します。ファイル処理に失敗した場合や再処理が必要な場合は、再試行 API を使用できます。
DocFlow はファイル再試行 API を提供しており、指定したタスクを再処理できます。再試行操作では、解析、分類、分割、抽出などを含む完全な処理フローを再実行します。
重要な制限: 抽出が成功または失敗したタスクで、かつメインタスクまたは親タスクのみ再試行できます。子タスクは再試行をサポートしていません。
ファイル処理を再試行
指定したタスク ID に対応するファイルを再処理します。
パラメータ説明
必須パラメータ
workspace_id: ワークスペース ID。Workspace ID の取得方法 を参照してください。
task_id: タスク ID。ファイルアップロード API のレスポンス、または確認 API から取得できます。
レスポンス説明
再試行に成功すると、標準レスポンスが返されます。
code: レスポンスステータスコード。200 は成功を表します
msg: レスポンスメッセージ
利用シーン
再試行 API は次のような場面に適しています。
- 処理失敗後の再試行: ファイル処理に失敗した場合、再試行 API を呼び出して再処理できます
- 設定更新後の再処理: 分類、抽出などの設定を更新した後、処理済みファイルを再処理して新しい設定を適用できます
重要な注意事項
再試行制限: 抽出が成功または失敗したタスクで、かつメインタスクまたは親タスクのみ再試行できます。子タスクは再試行をサポートしていません。
- タスク状態: 再試行操作ではファイルを再処理するため、既存の処理結果が上書きされる可能性があります
- 処理時間: 再試行操作では処理フローを再実行するため、時間がかかる場合があります。確認 API でタスク状態を確認することをおすすめします
- タスクタイプ制限: メインタスクまたは親タスクのみ再試行できます。子タスクは再試行できません
- 抽出ステータス制限: 抽出成功または抽出失敗ステータスのタスクのみ再試行できます