Che dữ liệu cá nhân API

Tìm và che dữ liệu cá nhân trong văn bản: CCCD, MST, SĐT, số tài khoản, thẻ, email, BHYT, biển số, họ tên, địa chỉ. Trả vị trí từng mục.

GETPOSThttps://apibox.io.vn/v1/vn-pii-redact
Bảo mật & Mã hoá▶ Dùng thử online

Gửi văn bản (ticket chăm sóc khách hàng, lịch sử chat, trích đoạn hợp đồng, dữ liệu đưa vào LLM), API trả về từng dữ liệu cá nhân kèm loại, vị trí, độ tin cậy, lý do, và văn bản đã che. Nhận diện: email, số điện thoại Việt Nam, CCCD (12 số, mã tỉnh và mã thế kỷ hợp lệ), CMND 9 số, mã số thuế (kiểm tra số kiểm tra), số tài khoản ngân hàng (sau STK / tài khoản / tên ngân hàng), thẻ thanh toán (Luhn và đầu số thẻ), mã BHXH, mã thẻ BHYT, số hộ chiếu, biển số xe, ngày sinh (sau "ngày sinh"), địa chỉ IPv4, họ tên (sau danh xưng anh / chị / ông / bà / "họ tên", hoặc cụm từ viết hoa bắt đầu bằng họ người Việt) và địa chỉ (sau "địa chỉ" / "thường trú", hoặc địa chỉ có số nhà được /v1/address-parse nhận diện). URL khi yêu cầu.

Chế độ: mask (giữ vài ký tự: 090* * 456, *******3456, N. V. A.), label ([PHONE_1], cùng giá trị giữ cùng số thứ tự), remove (xoá), hash (HMAC-SHA256 với key của bạn, mã ổn định để ghép dữ liệu) và pseudonym (giá trị giả cùng dạng, ổn định theo giá trị và khoá), hoặc detect chỉ liệt kê. Chọn loại dữ liệu bằng types, ngưỡng bằng min_confidence.

Xây dựng theo Luật Bảo vệ dữ liệu cá nhân 91/2025/QH15 (hiệu lực 01/01/2026) và Nghị định 356/2025/NĐ-CP: sensitive đánh dấu dữ liệu tài chính, sức khoẻ. Đây là công cụ hỗ trợ phát hiện, không bảo đảm tuân thủ: họ tên, địa chỉ viết bất thường có thể bị sót. Không lưu, không ghi log nội dung.

Tham số

TênVị tríKiểuBắt buộcMặc định
textbody|querystringcóVăn bản cần quét (tối đa 100.000 ký tự).
modebody|querystringkhôngmaskmask, label, remove, hash, pseudonym hoặc detect (chỉ liệt kê).
typesbody|querystringkhôngDanh sách cách nhau dấu phẩy: email, phone, cccd, cmnd, tax_code, bank_account, card, bhxh, bhyt, passport, plate, dob, ip, person, address, url (mặc định: tất cả trừ url).
keybodystringkhôngKhoá bí mật (từ 8 ký tự) cho hash / pseudonym: HMAC-SHA256, ổn định theo khoá.
min_confidencebody|querynumberkhông0.5Bỏ qua kết quả có độ tin cậy thấp hơn (0–1).
mask_charbody|querystringkhông*Ký tự dùng để che ở chế độ mask.

Ví dụ

curl -X POST "https://apibox.io.vn/v1/vn-pii-redact" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Khách hàng Nguyễn Văn An, CCCD 079203001234, SĐT 0909 123 456, email an.nguyen@gmail.com, STK VCB 0071000123456.","mode":"mask"}'

Kết quả trả về

{
  "redacted": "Khách hàng N. V. A., CCCD *********234, SĐT 090* *** 456, email a********@gmail.com, STK VCB *********3456.",
  "mode": "mask",
  "count": 5,
  "by_type": {
    "person": 1,
    "cccd": 1,
    "phone": 1,
    "email": 1,
    "bank_account": 1
  },
  "contains_sensitive": true,
  "entities": [
    {
      "type": "person",
      "text": "Nguyễn Văn An",
      "start": 11,
      "end": 24,
      "confidence": 0.9,
      "sensitive": false,
      "reason": "name after a title or \"tên\"",
      "replacement": "N. V. A."
    },
    {
      "type": "cccd",
      "text": "079203001234",
      "start": 31,
      "end": 43,
      "confidence": 0.98,
      "sensitive": false,
      "reason": "CCCD number (valid province and century codes)",
      "replacement": "*********234"
    },
    {
      "type": "phone",
      "text": "0909 123 456",
      "start": 49,
      "end": 61,
      "confidence": 0.95,
      "sensitive": false,
      "reason": "mobile number (MobiFone)",
      "replacement": "090* *** 456"
    },
    "…"
  ],
  "legal_basis": "Luật Bảo vệ dữ liệu cá nhân 91/2025/QH15 (hiệu lực 01/01/2026), NĐ 356/2025/NĐ-CP",
  "reviewed": "2026-11-11",
  "disclaimer": "Detection aid based on patterns, checksums and context words: names and addresses can be missed or over-matched. It does not by itself make processing compliant."
}

Ứng dụng

  • Che dữ liệu khách hàng trong ticket trước khi chia sẻ
  • Loại dữ liệu cá nhân khỏi đoạn chat trước khi gửi cho LLM
  • Giả danh hoá dữ liệu xuất cho phân tích hoặc đối tác
  • Rà soát tài liệu có chứa CCCD, số tài khoản, số thẻ

Hỏi đáp

Nhận diện họ tên có chính xác không?

Tên đứng sau danh xưng hoặc từ khoá "tên / họ tên" rất đáng tin; tên đứng riêng được nhận khi bắt đầu bằng họ người Việt, nên đôi khi trùng tên địa danh, tên đường. Xem độ tin cậy và chỉnh min_confidence.

Có khôi phục được giá trị đã băm không?

Với hash hoặc pseudonym và khoá của bạn, cùng giá trị luôn cho cùng mã nên có thể ghép dữ liệu; không có khoá thì không đảo ngược được. Nếu không truyền khoá, mã băm là SHA-256 thuần và có thể bị đoán.

Dùng công cụ này là đủ tuân thủ chưa?

Không công cụ nào tự làm được điều đó. Nó giúp giảm thiểu, khử nhận dạng dữ liệu như luật yêu cầu, còn các nghĩa vụ pháp lý khác (đồng ý, hồ sơ, bảo mật) vẫn thuộc về bạn.

API liên quan

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →