ファイルのダウンロード
ファイルのダウンロードの手順を以下に示します。
図には、APIのリクエストインタフェースとレスポンスインタフェースのうち、説明で使用している項目のみ記載しています。
図3.4 ダウンロードの流れ
1) Transact APIをbeginコマンドで呼び出します。session_validationには前回リクエスト時のレスポンスデータから取得したsession_validationの値を設定します。
object_idにはGetObjectPath APIのレスポンスデータ等から取得した、ダウンロードするファイルのobject_idの値を設定します。
4) DownloadObject APIを呼び出します。session_validation、operation_idには3) で取得した値を設定します。
6) データをファイルに保存します。
7) Transact APIをcommitコマンドで呼び出します。session_validation、operation_idには3) で取得した値を設定します。
DownloadObject APIが正常に処理された場合、5) のレスポンスデータにsession_validationは含まれません。
9) 処理が正常に行われた場合、レスポンスデータからsession_validationを取得し、次のリクエストに備えます。
データ検証を行う必要がある場合は、続けて以下の手順を実行します。
12) ファイルサイズによるデータ検証を行う場合、2) で取得したsizeの値とダウンロードしたファイルデータのサイズを比較します。
一致すれば、ファイルサイズによるデータ検証は成功です。
DownloadObject APIの呼び出し以降にエラーを検出した場合はロールバックする必要があります。