JSON Swiss

JSON Swiss

Trình tạo JSON Schema

Đầu vào: Dữ liệu JSON

1

Đầu ra: JSON Schema

Cài đặt
Tự tạo khi input thay đổiBật

Tạo JSON Schema

Nhập dữ liệu JSON bên trái để tự động tạo JSON Schema tương ứng

• Hỗ trợ object và array lồng nhau

• Tự động phát hiện kiểu dữ liệu

• Tạo quy tắc validation

Cách tạo JSON Schema từ JSON – hướng dẫn từng bước

Dùng trình tạo JSON Schema trực tuyến này để tạo định nghĩa schema từ dữ liệu JSON mẫu cho validation, tài liệu và API contracts.

  1. Bước 1 – Cung cấp JSON mẫu

    • Dán một JSON object hoặc array đại diện vào trình soạn thảo bên trái.
    • Dùng dữ liệu production thực tế để schema phản ánh chính xác cấu trúc dữ liệu của bạn.
    • Bao gồm ví dụ cho mọi giá trị có thể có và cấu trúc lồng nhau.

  2. Bước 2 – Xem schema đã tạo

    • Schema xuất hiện bên phải với kiểu được suy luận, trường bắt buộc và định nghĩa cấu trúc.
    • Kiểm tra array items, nested objects và kiểu thuộc tính có đúng kỳ vọng không.
    • Xác nhận trường optional và required được nhận diện chính xác.

  3. Bước 3 – Tùy chỉnh schema (tùy chọn)

    • Sao chép schema đã tạo và thêm quy tắc validation, mô tả hoặc ràng buộc tùy chỉnh.
    • Thêm enum giá trị và minLength/maxLength, hoặc pattern regex khi cần.
    • Định nghĩa oneOf hoặc anyOf cho union types.

  4. Bước 4 – Dùng schema

    • Tải xuống hoặc sao chép schema để dùng với JSON validators, công cụ tài liệu API hoặc code generators.
    • Tích hợp với thư viện validation như Ajv (JavaScript), jsonschema (Python) hoặc các thư viện tương tự.
    • Tham chiếu schema trong OpenAPI/Swagger hoặc dùng để tạo code an toàn về kiểu.

Mẹo nhanh cho việc tạo schema

  • Luôn validate schema đã tạo bằng JSON validator hoặc runtime library trước khi dùng trong production.
  • Dùng dữ liệu mẫu thực tế để công cụ suy luận đúng kiểu và required properties.
  • Giữ một schema chuẩn cho mỗi payload (ví dụ request/response API) để tránh drift giữa các môi trường.

Lưu ý về hỗ trợ keyword schema

Nếu bạn thêm các keyword nâng cao như $ref, anyOf, oneOf, hoặc allOf, hãy validate bằng JSON Schema validator đầy đủ (ví dụ Ajv) và cân nhắc dereference schema trước khi tạo mock data.

Ví dụ: JSON → JSON Schema
// JSON input
{
  "id": 1,
  "name": "Maeve Winters",
  "email": "[email protected]",
  "active": true,
  "tags": ["developer", "backend"]
}

// Generated JSON Schema (simplified)
{
  "type": "object",
  "properties": {
    "id": { "type": "number" },
    "name": { "type": "string" },
    "email": { "type": "string" },
    "active": { "type": "boolean" },
    "tags": {
      "type": "array",
      "items": { "type": "string" }
    }
  },
  "required": ["id", "name", "email", "active", "tags"]
}

Công cụ JSON Schema & validation liên quan

Dùng các công cụ này cùng schema generator để validate, tài liệu hóa và làm việc với dữ liệu JSON.

JSON Schema Validator

Kiểm tra JSON payloads theo các schema keyword phổ biến và phát hiện mismatch sớm.

JSON Schema Mock Data Generator

Tạo JSON ví dụ thực tế từ schema cho tests, docs và fixtures.

JSON Formatter

Định dạng và làm sạch JSON mẫu trước khi tạo schema để tăng độ chính xác.

Schema Library

Khám phá patterns và ví dụ schema cho objects, arrays, enums và quy tắc validation.

JSON sang TypeScript Types

Tạo TypeScript interfaces từ chính JSON dùng để tạo schema.

JSON sang Java Classes

Tạo Java POJOs từ JSON và dùng schema để runtime validation với thư viện như Jackson.

Câu hỏi thường gặp

JSON Schema là gì?

JSON Schema là một bộ từ vựng cho phép bạn chú thích và validate tài liệu JSON. Nó cung cấp một hợp đồng về dữ liệu JSON nào là cần thiết cho một ứng dụng và cách tương tác với nó.

Tôi tạo schema từ dữ liệu JSON như thế nào?

Chỉ cần dán dữ liệu JSON vào trình soạn thảo đầu vào. Schema sẽ được tạo tự động dựa trên cấu trúc dữ liệu của bạn, bao gồm kiểu dữ liệu, trường bắt buộc và patterns.

Schema tạo ra bao gồm những gì?

Schema bao gồm kiểu dữ liệu, required properties, mô tả thuộc tính, định nghĩa phần tử mảng, cấu trúc object và các ràng buộc validation dựa trên pattern dữ liệu JSON.

Tôi có thể tùy chỉnh schema đã tạo không?

Có! Sau khi tạo, bạn có thể sao chép schema và chỉnh sửa để thêm ràng buộc, mô tả hoặc quy tắc validation cho trường hợp sử dụng của bạn.

Trình tạo JSON Schema | JSONSwiss