メインコンテンツまでスキップ

CDR無害化ファイルダウンロード

無害化処理が完了したファイルをダウンロードします。
成功時ファイルバイナリストリームを返しますが、失敗した場合JSON形式のエラーメッセージを返します。

Important Notes

  • Prerequisite: 必ず状態照会API(GET /v5/cdr/{jobID}の応答codeが**0(成功)または1(例外/原本搬入)**の時だけ呼び出す必要があります。
  • Blocked Files: 政策によってブロックされたファイル(code: 2はダウンロードできません。
  • Expiration: サーバーのファイル保管期間が過ぎたファイルは自動的に削除され、ダウンロードできません(code: -2). 再リクエストが必要です。

Method

GET

/v5/download/{jobID}

Request Path Parameter

KEYOBJECTDESC
jobIDStringダウンロードする作業 ID (必須)

Response

1. 成功 (File Download)

  • Content-Type: application/octet-stream
  • Body: Binary Data (File)

2. 失敗 (JSONエラー応答)

  • Content-Type: application/json
KEYOBJECTDESC
jobIDString作業 ID
codeint結果コード(下の表を参照)
msgString結果メッセージ

Response Code (Failure Case)

CODEDESCDETAIL
5無効なリクエストの拒否無効なリクエストまたはアクセス権がない場合
3無害化進行中ダウンロードをリクエストしたが、まだ完了していない場合
2ポリシーによるファイルブロックブロックされたファイルはダウンロードできません。
-1不明なエラーサーバ内部エラーによりダウンロード不可
-2ファイルがありません保管期間が満了して削除されたか、存在しないファイル

Sample

REQUEST

curl -X GET "{{url}}/v5/download/test-job-001" -O

RESPONSE - 成功

  • ファイルのダウンロードが開始されます。

RESPONSE - 失敗 (Code: 2, ブロックされたファイル)

{
"jobID": "test-job-001",
"code": 2,
"msg": "정책에 의한 파일 차단으로 다운로드 불가"
}

RESPONSE - 失敗 (Code: 3, 進行中)

{
"jobID": "test-job-001",
"code": 3,
"msg": "무해화가 진행중인 경우"
}