エンドポイント › 無害化リクエスト
無害化リクエスト
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 | 無害化ファイルの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 | 毎分・同時実行の制限、または1日50件を超過(Retry-Afterを参照) |
| 503 | engine_busy | 一時的に処理できません — カウントしません |