엔드포인트 › 무해화 요청
무해화 요청
POSThttps://api.akdan.co.kr/v1/disarm
문서에서 매크로 · 스크립트 · 외부 링크 같은 활성 요소를 걷어내고 본문과 서식은 그대로 둔 파일을 돌려줍니다. 분석과 같은 키를 쓰고 건수를 합산합니다.
disarmed_url은 [N시간] 동안 내려받을 수 있습니다. 만료되면 null이 됩니다.
요청
| 이름 | 위치 | 설명 |
|---|---|---|
| Authorization 필수 | header | Bearer <평가 키> |
| file 필수 | form-data | 무해화할 문서 1개 (DOC(X) · XLS(X) · PPT(X) · PDF · HWP [확인]) |
| Idempotency-Key | header | 같은 값으로 다시 보내면 중복 차감 없이 같은 결과를 돌려줍니다 |
응답 필드
| data.disarmed_url | 무해화 파일 주소 ([N시간] 유효) |
| data.removed[] | 제거(removed)하거나 무력화(neutralized)한 요소와 위치 |
| data.preserved | 본문 · 서식 보존 여부 |
| 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 | 일시적 처리 불가 — 차감하지 않음 |