DEVELOPERS · API DOCS v1

Evaluation API docsCall analysis and disarm with the same key

Before you deploy, call analysis (Hyper Sandbox) and disarm (CDR) directly from your own systems with your own samples.
This is not a product for sale — it's an evaluation API we open free of charge during your review period. Base URL https://api.akdan.co.kr/v1

  • 30 daysEvaluation period
  • 50Requests per day
  • 2,000Requests in total · analysis + disarm
Endpoints › Analysis request

Analysis request

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

Send one file to be analyzed in the Hyper Sandbox. It finishes in 0.27 s on average, and the result comes back directly in the response. If processing takes longer, the API returns 202 with a filescan_id — fetch the result with Get result. [To be updated once sync/async is finalized]

Request

NameInDescription
Authorization RequiredheaderBearer <evaluation key>
file Requiredform-dataOne file to analyze, up to [N] MB
Idempotency-Key headerResend with the same value to get the same result without being counted twice

Response fields

data.verdictmalicious · suspicious · clean · unknown
data.riskRisk score 0–10 (same scale as ZX HUB)
data.file.sha256File hash
data.mitre[]ATT&CK technique IDs
data.evidence[]Risk signals (risk · description · location)
quotaday_left · total_left · expires_at

Errors

401invalid_keyMissing key, or a key stopped by reissue
403evaluation_ended30-day evaluation ended or 2,000 requests used up — request an extension in My API
413file_too_largeFile too large
415unsupported_typeUnsupported file type
429rate_limited · daily_limitPer-minute or concurrency limit, or more than 50 requests in a day (see Retry-After)
503engine_busyTemporarily unavailable — not counted

Disarm with the same key

POST /v1/disarm

Send a file the same way to get back a file with active elements such as macros, scripts and external links removed. Requests are counted together with analysis, and the response includes disarmed_url (download, valid for [N hours]), removed[] (removed elements and their locations) and preserved (whether body text and formatting were preserved).

Disarm request docs →

Need an evaluation key?

Sign in and apply — we'll issue a key after review. One key per company.