Giới thiệu Tạo JSON Schema — Hướng dẫn chi tiết
JSON Schema Generator tự động suy luận đặc tả JSON Schema tiêu chuẩn trực tiếp từ dữ liệu JSON mẫu đầu vào. Công cụ hỗ trợ các tiêu chuẩn Draft-07, Draft 2019-09 và Draft 2020-12.
Bộ xử lý phân tích cấu trúc dữ liệu để nhận diện các kiểu nguyên thủy (string, integer, number, boolean, array, object, null) và phát hiện các định dạng ngữ nghĩa như date-time, email và uri. Bạn có thể tùy chỉnh các hộp kiểm thuộc tính `required` và sao chép mã schema chuẩn xác chỉ với một cú nhấp chuột.
Tính năng và khả năng nổi bật
- Tự động suy luận định nghĩa JSON Schema chuẩn từ các đối tượng và mảng JSON tùy ý
- Phân biệt chính xác giữa số nguyên (integer), số thực dấu phẩy động và các kiểu nguyên thủy khác
- Nhận diện phỏng đoán các định dạng ngữ nghĩa bao gồm ISO date-time, email và uri
- Hộp kiểm trực quan để bật/tắt ràng buộc `required` trên các thuộc tính kèm tính năng sao chép tức thì
Cách sử dụng
- 1
Dán payload JSON mẫu đại diện vào khung nhập liệu bên trái.
- 2
Nhấp vào Generate để tự động phân tích kiểu thuộc tính và độ sâu cấu trúc.
- 3
Bật/tắt cờ trường `required` nếu cần, sau đó sao chép JSON Schema vừa được tạo.
Trường hợp sử dụng phổ biến
- → Tạo schema hợp đồng từ các mẫu phản hồi API hiện có trong quá trình kiểm thử tích hợp
- → Chuẩn bị schema nguồn cho các công cụ như `json-schema-to-typescript`
- → Áp đặt các ràng buộc cấu trúc lên payload sự kiện trên message bus bất đồng bộ
Công cụ liên quan
Tạo thẻ Meta SEO & OpenGraph
Tạo bộ thẻ meta chuẩn cho SEO, OpenGraph (Facebook) và Twitter Card với trình xem trước trực quan.
Tạo tệp .gitignore
Tạo tệp .gitignore hoàn chỉnh cho Node.js, Python, Java, Go, Rust, macOS, Windows và IDE.
Tạo giấy phép mã nguồn mở
Chọn và tạo văn bản giấy phép mã nguồn mở phổ biến (MIT, Apache 2.0, GPL 3.0, BSD) với thông tin bản quyền.
Tạo tài liệu README.md
Tạo tệp tài liệu README.md chuyên nghiệp cho dự án với các huy hiệu (Badges), hướng dẫn cài đặt và cấu trúc mã nguồn.
Soạn thảo Conventional Commits
Trình soạn thảo thông điệp commit chuẩn hóa theo quy ước Conventional Commits (feat, fix, docs, chore).
Tính toán phiên bản SemVer
Phân tích, so sánh và kiểm tra quy tắc phạm vi phiên bản phần mềm theo tiêu chuẩn Semantic Versioning.
Câu hỏi thường gặp và quyền riêng tư
Công cụ xử lý mảng chứa các đối tượng có thuộc tính không đồng nhất như thế nào?
Bộ xử lý sẽ hợp nhất các thuộc tính từ tất cả đối tượng trong mảng để tạo ra một schema đối tượng thống nhất có thể xác thực mọi phần tử mẫu.
Làm thế nào để xác thực payload dựa trên schema đã tạo?
Bạn có thể sử dụng các thư viện như `ajv` trong môi trường Node.js hoặc trình duyệt: biên dịch schema bằng `const validate = ajv.compile(schema)` và chạy `validate(data)`.