Nhận diện loại file API

Nhận diện loại thật của file từ nội dung (hơn 130 định dạng), so với tên và Content-Type, cảnh báo file thực thi giả dạng và macro.

Tham số

Ví dụ

curl -X POST "https://apibox.io.vn/v1/file-type" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "0=@./my-file"

const form = new FormData();
form.append('0', fileInput.files[0]);

const res = await fetch('https://apibox.io.vn/v1/file-type', {
  method: 'POST',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
  body: form,
});
console.log(await res.json());

import requests

res = requests.post(
    "https://apibox.io.vn/v1/file-type",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    files={"0": open("my-file", "rb")},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/file-type');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => ['0' => new CURLFile('my-file')],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Kết quả trả về

{
  "source": "upload",
  "file_name": "contract.docx",
  "size_bytes": 401,
  "bytes_inspected": 401,
  "type": {
    "extension": "docm",
    "mime": "application/vnd.ms-word.document.macroEnabled.12",
    "kind": "document",
    "description": "Word document with macros",
    "executable": false,
    "details": {
      "entries": 3,
      "entries_listed": "all",
      "macros": true
    }
  },
  "extension": "docx",
  "extension_matches": false,
  "declared_content_type": null,
  "content_type_matches": null,
  "expected_extensions": [
    "docm",
    "dotm"
  ],
  "risk": "high",
  "warnings": [
    {
      "code": "macros",
      "severity": "high",
      "message": "The file contains VBA macros but is named .docx (macro-free format)"
    },
    {
      "code": "extension_mismatch",
      "severity": "low",
      "message": "The name ends in .docx but the content is Word document with macros (.docm)"
    }
  ]
}

Ứng dụng

• Kiểm tra file người dùng tải lên trước khi lưu (theo OWASP)
• Chặn file thực thi đổi tên thành ảnh hoặc PDF
• Phát hiện file Office chứa macro gửi qua e-mail
• Sửa Content-Type sai khi phục vụ file của người dùng

Hỏi đáp

API liên quan