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

CDR 無害化状態の照会

受け付けた無害化リクエストの進行状況を照会します。
作業 ID(jobID)をキーとして無害化進行状況を照会します。

Important Notes​

  • Polling Frequency: 状態照会周期200msを推奨します。あまりにも頻繁なリクエスト（例：ループ内の即時呼び出し）はDDoS攻撃と見なされ、ブロックされる可能性があります。
  • Flow: ステータスコード(code)が0または1の時だけファイルダウンロードAPI(GET /v5/download/{jobID})を呼び出す必要があります。
  • Response Format: すべての応答は200 OKHTTP ステータスコードを持ち、実際の結果は JSON ボディのcodeフィールドで区切ります。

Method​

GET​

/v5/cdr/{jobID}

Request Path Parameter​

KEYOBJECTDESC
jobIDString状態を照会する作業 ID (必須)

Response Body (json)​

KEYOBJECTDESC
jobIDString作業 ID
codeintステータスコード（下の表を参照）
msgStringステータスメッセージ
logReasonint詳細ログ理由コード

Response Code​

CODEDESCDETAIL
0ファイル再構成完了（無害化成功）安全なファイルが生成されたため、ダウンロード可能です。
1政策による無害化省略 (原本持ち込み)ポリシーに従って、原本ファイルが持ち込まれました。ダウンロード可能です。
2ファイルブロック脅威要素が発見されたか、ブロックポリシーによってファイルが削除されました。ダウンロードできません。
3無害化作業進行中まだ処理が完了していません。しばらくしてから再度確認してください。
5無効なリクエストの拒否無効なリクエストまたはアクセス権がない場合です。
-1サーバ内部エラー不明なエラーが発生しました。
-3存在しない作業 ID無効なIDまたは保管期間が満了した作業です。

Sample​

REQUEST​

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

RESPONSE - 成功 (Code: 0)​

{
  "jobID": "test-job-001",
  "code": 0,
  "msg": "파일 재구성 완료",
  "logReason": 200000
}

RESPONSE - 例外 (Code: 1)​

{
    "jobID": "test-job-001",
    "code": 1,
    "msg": "[예외] 비밀번호 보호 문서 파일 원본 반입",
    "logReason": 230243
}

RESPONSE - ブロック (Code: 2)​

{
    "jobID": "test-job-001",
    "code": 2,
    "msg": "[차단] 확장자 위변조 파일 차단",
    "logReason": 220355
}

RESPONSE - 進行中 (Code: 3)​

{
  "jobID": "test-job-001",
  "code": 3,
  "msg": "무해화 작업 진행 중",
  "logReason": 100001
}

RESPONSE - 作業 ID がありません (Code: -3)​

{
  "jobID": "test-job-001",
  "code": -3,
  "msg": "JobId does not exist",
}

Processing Flow​

  • ここからは外部に公開してはいけない、開発情報です。