Cách Sử Dụng JSON Schema để Xác Thực Dữ Liệu của Bạn

By Đội ngũ JSONValidator.dev • 2025-07-04

JSON Schema là gì?

JSON Schema là một chuẩn mô tả cấu trúc, các trường bắt buộc và kiểu dữ liệu trong JSON của bạn. Hãy xem nó như một hợp đồng hoặc bản thiết kế cho JSON hợp lệ. JSON Schema được viết bằng chính JSON, giúp máy móc dễ đọc và bạn cũng dễ dàng chỉnh sửa.

JSON Schema không chỉ để xác thực—nó còn hữu ích cho việc tạo mã, tài liệu API và hỗ trợ hoàn thành tự động trong trình soạn thảo.

Tại sao nên xác thực với Schema?

  • Ngăn ngừa lỗi bằng cách phát hiện dữ liệu không hợp lệ hoặc thiếu trước khi gây sự cố.
  • Đảm bảo dữ liệu nhất quán giữa các nhóm, ứng dụng hoặc API khác nhau.
  • Tự động tạo tài liệu dựa trên schema.
  • Giúp trình soạn thảo và công cụ cung cấp tính năng hoàn thành tự động và hỗ trợ trực tiếp tốt hơn.
Ngay cả một schema đơn giản cũng có thể bắt được lỗi thường gặp, tiết kiệm nhiều giờ sửa lỗi sau này.

Ví Dụ Đơn Giản: Schema Cơ Bản

Dưới đây là một đối tượng JSON cơ bản, kèm schema tối giản để xác thực cấu trúc của nó:

{
  "name": "Alice",
  "age": 30
}
{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "number" }
  },
  "required": ["name", "age"]
}

Schema này đảm bảo đối tượng phải có trường 'name' (kiểu chuỗi) và 'age' (kiểu số).

Cách Viết Schema Tùy Chỉnh

Bạn có thể định nghĩa các quy tắc nâng cao trong schema: giới hạn giá trị trường, định nghĩa đối tượng lồng nhau, hoặc đặt giới hạn số tối thiểu/tối đa. Dưới đây là ví dụ xác thực mảng sản phẩm:

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": { "type": "string" },
      "price": { "type": "number", "minimum": 0 },
      "tags": {
        "type": "array",
        "items": { "type": "string" }
      }
    },
    "required": ["id", "price"]
  }
}
Bắt đầu từ những schema nhỏ, xây dựng dần dần và dùng công cụ trực tuyến để kiểm tra từng bước.

Sử Dụng JSONValidator.dev để Xác Thực Schema

  1. Dán dữ liệu JSON của bạn vào trình soạn thảo chính.
  2. Dán JSON Schema của bạn vào trình soạn thảo schema bên dưới.
  3. Nhấn Xác Thực JSON Theo Schema Này.
  4. Xem kết quả xác thực, các lỗi sẽ được tô sáng và giải thích chi tiết.
Mọi xác thực diễn ra ngay trên trình duyệt của bạn—dữ liệu không bao giờ được gửi đi đâu cả.

Khắc Phục Lỗi Xác Thực Schema

Các nguyên nhân phổ biến gây lỗi xác thực gồm:

  • Thiếu trường dữ liệu bắt buộc trong dữ liệu của bạn.
  • Loại giá trị không khớp với schema (ví dụ: chuỗi thay vì số).
  • Schema bị lỗi hoặc có lỗi đánh máy.
Hãy đọc kỹ thông báo lỗi—chúng thường chỉ rõ trường dữ liệu và sự không khớp kiểu dữ liệu.

Kết Luận

Xác thực bằng JSON Schema là cách mạnh mẽ giúp dữ liệu của bạn trở nên chắc chắn và không lỗi. Hãy thử tạo schema cho dữ liệu của bạn với Trình Tạo JSON Schema miễn phí của chúng tôi và xác thực trực tuyến ngay hôm nay!