- 利用可能なすべての Skill の一覧を取得する
- 空のトランザクションを作成する
- トランザクション内で処理するファイルのセットを追加する
- トランザクションを開始する
- トランザクションのステータスを監視する
- 元ファイルと結果ファイルをダウンロードする
利用可能なすべての Skill の一覧を取得する
skills リソースに GET リクエストを送信します。
次のコマンドを実行します：
その結果、アプリケーション インスタンスに追加されたすべての Skill の情報が返されます。
空のトランザクションを作成する
transactions リソースに次の POST リクエストを送信します。
次のコマンドを実行します：
リクエストの本文に、前の API 呼び出しで返された skillId Parameter を指定します。これにより、作成されたトランザクションの id を含むレスポンスが返されます。
トランザクションで処理するファイルセットの追加
トランザクションにファイルを直接追加する
POST リクエストを transactions/<transaction-id>/files リソースに送信します。
次のコマンドを実行します：
その結果、追加されたファイルとその識別子の一覧を含むレスポンスが返ってきます。この呼び出しを複数回繰り返すことで、必要な数だけファイルを追加できます。
ファイルのアップロードに関する追加オプション:
ドキュメントにファイルを追加する
POST リクエストを transactions/<transaction-id>/documents リソースに送信して、ドキュメントを作成します。
その結果、Document 識別子を含むレスポンスが返されます。
次に、transactions/<transaction-id>/documents/<document-id>/sourceFiles リソースに POST リクエストを送信して、Document にファイルを追加します。
トランザクションの開始
transactions/<transaction-id>/start リソースに次の POST リクエストを送信します。
トランザクションのステータスを監視する
transactions/<transaction_id> リソースへ GET リクエストを送信します。
その結果、トランザクションのステータスを含むレスポンスが返されます。トランザクション処理のステータスは次のいずれかです。
New。トランザクションは作成されていますが、まだ処理キューに入っていません。Queued。トランザクションは処理のためにキューに入っています。InProgress。トランザクションは処理中です。Processed。トランザクションは正常に処理完了しました。ProcessedWithWarnings。トランザクションは処理されましたが、警告が発生しました。NotProcessed。エラーのため、トランザクションは処理されませんでした。Deleted。トランザクションはユーザーによって、または保持ポリシーにより自動的に削除されました。
Processed または ProcessedWithWarnings の場合、手順 6 に進みます。
ソースファイルのダウンロード
transactions/<transaction-id>/documents リソースに GET リクエストを送信し、トランザクションの識別子を指定します。
その結果、このトランザクション内で作成されたドキュメントの一覧が返されます。レスポンスにはこれらのドキュメントの識別子も含まれており、特定のドキュメントの詳細情報を取得する際に必要になる場合があります。
特定のドキュメントに追加されたファイルの一覧を取得するには、transactions/<transaction-id>/documents/<document-id> リソースに GET リクエストを送信します。
その結果、Document に関する情報が返されます。レスポンスには、Document に追加されたファイルの識別子も含まれます。
ソースファイルをダウンロードするには、transactions/<transaction-id>/files/<file-id>/download リソースに GET リクエストを送信します。