DEVELOPERS · API DOCS v1

評価用APIドキュメント分析と無害化を同じキーで呼び出せます

導入前に、社内システム・保有サンプルで分析(ハイパーサンドボックス)と無害化(CDR)を直接呼び出してみてください。
販売用ではなく、ご検討期間中に無料で提供する評価用APIです。ベースURL https://api.akdan.co.kr/v1

  • 30日間評価期間
  • 50件1日あたり
  • 2,000件合計・分析 + 無害化の合算
エンドポイント › 分析リクエスト

分析リクエスト

POSThttps://api.akdan.co.kr/v1/filescan

ファイルを1つ送信し、ハイパーサンドボックスで分析します。平均0.27秒で完了し、結果はそのままレスポンスで返ります。処理が長引く場合は202とfilescan_idを返すので、結果照会で取得してください。[同期・非同期の確定後に修正]

リクエスト

名前位置説明
Authorization 必須headerBearer <評価キー>
file 必須form-data分析するファイル1つ、最大[N] MB
Idempotency-Key header同じ値で再送すると、二重にカウントされず同じ結果を返します

レスポンスフィールド

data.verdictmalicious · suspicious · clean · unknown
data.risk0–10の危険度(ZX HUBと同じ基準)
data.file.sha256ファイルハッシュ
data.mitre[]ATT&CKテクニックID
data.evidence[]危険シグナル(危険度・説明・位置)
quotaday_left · total_left · expires_at

エラー

401invalid_keyキーがない、または再発行で停止したキー
403evaluation_ended30日間の評価終了、または2,000件を使い切った場合 — マイAPIで延長をリクエスト
413file_too_largeファイルサイズ超過
415unsupported_type非対応の形式
429rate_limited · daily_limit毎分・同時実行の制限、または1日50件を超過(Retry-Afterを参照)
503engine_busy一時的に処理できません — カウントしません

無害化も同じキーで

POST /v1/disarm

同じ方法でファイルを送ると、マクロ・スクリプト・外部リンクなどのアクティブ要素を取り除いたファイルを返します。件数は分析と合算され、レスポンスにはdisarmed_url(ダウンロード用、[N時間]有効)、removed[](除去した要素と位置)、preserved(本文・書式の保持有無)が含まれます。

無害化リクエストのドキュメント →

評価用キーが必要ですか?

ログインして申請すると、審査後にキーを発行します。キーは1社につき1つです。