엔드포인트 › 분석 요청
분석 요청
POSThttps://api.akdan.co.kr/v1/filescan
파일 하나를 보내 하이퍼 샌드박스로 분석합니다. 평균 0.27초 안에 끝나며, 결과는 바로 응답으로 돌아옵니다. 처리가 길어지면 202와 filescan_id를 돌려주니 결과 조회로 가져가세요. [동기 · 비동기 확정 후 수정]
요청
| 이름 | 위치 | 설명 |
|---|---|---|
| Authorization 필수 | header | Bearer <평가 키> |
| file 필수 | form-data | 분석할 파일 1개, 최대 [N] MB |
| Idempotency-Key | header | 같은 값으로 다시 보내면 중복 차감 없이 같은 결과를 돌려줍니다 |
응답 필드
| data.verdict | malicious · suspicious · clean · unknown |
| data.risk | 0–10 위험도 (ZX HUB와 같은 기준) |
| data.file.sha256 | 파일 해시 |
| data.mitre[] | ATT&CK 기법 ID |
| data.evidence[] | 위험 신호 (위험도 · 설명 · 위치) |
| quota | day_left · total_left · expires_at |
오류
| 401 | invalid_key | 키가 없거나 재발급으로 멈춘 키 |
| 403 | evaluation_ended | 30일 평가 종료 또는 2,000건 소진 — 내 API에서 연장 요청 |
| 413 | file_too_large | 파일 크기 초과 |
| 415 | unsupported_type | 지원하지 않는 형식 |
| 429 | rate_limited · daily_limit | 분당 · 동시 제한, 또는 하루 50건 초과 (Retry-After 참고) |
| 503 | engine_busy | 일시적 처리 불가 — 차감하지 않음 |
무해화도 같은 키로
POST /v1/disarm같은 방식으로 파일을 보내면 매크로 · 스크립트 · 외부 링크 같은 활성 요소를 걷어낸 파일을 돌려줍니다. 분석과 건수를 합산하며, 응답에 disarmed_url(내려받기, [N시간] 유효), removed[](제거한 요소와 위치), preserved(본문 · 서식 보존 여부)가 담깁니다.