DEVELOPERS · API DOCS v1

평가용 API 문서분석과 무해화를 같은 키로 호출합니다

도입 전 사내 시스템 · 보유 샘플로 분석(하이퍼 샌드박스)과 무해화(CDR)를 직접 호출해 보세요.
판매용이 아닌, 검토 기간 동안 무료로 여는 평가용 API입니다. 기본 주소 https://api.akdan.co.kr/v1

  • 30일평가 기간
  • 50건하루
  • 2,000건총 · 분석 + 무해화 합산
엔드포인트 › 분석 요청

분석 요청

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

파일 하나를 보내 하이퍼 샌드박스로 분석합니다. 평균 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분당 · 동시 제한, 또는 하루 50건 초과 (Retry-After 참고)
503engine_busy일시적 처리 불가 — 차감하지 않음

무해화도 같은 키로

POST /v1/disarm

같은 방식으로 파일을 보내면 매크로 · 스크립트 · 외부 링크 같은 활성 요소를 걷어낸 파일을 돌려줍니다. 분석과 건수를 합산하며, 응답에 disarmed_url(내려받기, [N시간] 유효), removed[](제거한 요소와 위치), preserved(본문 · 서식 보존 여부)가 담깁니다.

무해화 요청 문서 →

평가용 키가 필요하신가요?

로그인하고 신청하면 검토 후 키를 발급합니다. 회사당 키 1개입니다.