Tạo JSON Schema
Tự động tạo JSON Schema từ dữ liệu JSON
Schema được suy ra từ dữ liệu mẫu. Schema của phần tử mảng lấy theo phần tử đầu tiên; hãy xem lại và chỉnh sửa schema trước khi dùng để kiểm tra hợp lệ.
Đã xử lý ngay trên thiết bị này. Văn bản của bạn không được tải lên.
Tạo JSON Schema trực tuyến miễn phí
Công cụ tạo JSON Schema của chúng tôi phân tích dữ liệu JSON mẫu và tạo ngay định nghĩa JSON Schema hợp lệ, với khả năng nhận diện kiểu chính xác, xử lý đối tượng lồng nhau và suy ra kiểu phần tử mảng. Chỉ cần dán một đối tượng JSON, chọn phiên bản draft ưa thích và nhận schema dùng cho xác thực API, tạo biểu mẫu hoặc làm tài liệu, mà không phải tự viết tay dòng mã schema nào.
Công cụ hỗ trợ JSON Schema draft-04, draft-06 và draft-07, bao phủ các phiên bản được dùng rộng rãi nhất trong hệ sinh thái. Công cụ duyệt đệ quy qua cấu trúc JSON của bạn, nhận diện chuỗi, số, số nguyên, boolean, null, đối tượng và mảng. Với mảng, schema được suy ra từ phần tử đầu tiên, đảm bảo định nghĩa phần tử chính xác ngay cả với cấu trúc lồng nhau phức tạp.
Các tùy chọn cho phép bạn bật tắt mảng thuộc tính bắt buộc, thêm mô tả giữ chỗ để làm tài liệu và áp dụng additionalProperties: false để xác thực nghiêm ngặt. Khi đã hài lòng, hãy tải kết quả về dưới dạng tệp .schema.json hoặc sao chép vào bộ nhớ tạm chỉ với một cú nhấp. Mọi thứ chạy cục bộ trong trình duyệt của bạn, dữ liệu của bạn không bao giờ được tải lên máy chủ.
Tính năng chính
- Hỗ trợ JSON Schema draft-04, draft-06 và draft-07 với URI $schema đúng chuẩn
- Tự động nhận diện kiểu string, number, integer, boolean, null, object và array
- Tạo schema đệ quy cho đối tượng và mảng lồng sâu
- Suy ra kiểu phần tử mảng dựa trên phần tử đầu tiên
- Mảng thuộc tính “required” có thể cấu hình để kiểm soát mức độ chặt chẽ của xác thực
- Tạo mô tả “description” giữ chỗ tùy chọn để schema tự có tài liệu
- Nút bật tắt “additionalProperties: false” để buộc đối tượng đúng hình dạng nghiêm ngặt
- Tải schema đã tạo về dưới dạng tệp .schema.json
- Sao chép vào bộ nhớ tạm chỉ với một cú nhấp
- Có sẵn JSON mẫu để thử nghiệm nhanh
Cách dùng công cụ Tạo JSON Schema
- Cấu hình tùy chọn schema: Chọn phiên bản draft, rồi bật hoặc tắt mảng required, mô tả và additionalProperties theo nhu cầu của bạn.
- Dán JSON của bạn: Nhập hoặc dán một đối tượng JSON mẫu vào khung đầu vào. Bạn cũng có thể nhấp “Sample JSON” để nạp ví dụ.
- Tạo schema: Nhấp “Generate Schema” để tạo kết quả JSON Schema ở khung bên phải.
- Xem lại và tinh chỉnh: Kiểm tra kết quả. Điều chỉnh các tùy chọn như trường bắt buộc hoặc mô tả rồi tạo lại khi cần.
- Xuất schema: Nhấp “Copy” để chép schema vào bộ nhớ tạm, hoặc “Download .schema.json” để lưu thành tệp.
Trường hợp sử dụng
- Đặc tả OpenAPI / Swagger: Tạo định nghĩa schema cho nội dung yêu cầu và phản hồi trong tài liệu API của bạn.
- Xác thực yêu cầu ở backend: Tạo schema để xác thực payload JSON đến trong Express, FastAPI, Spring Boot hoặc các framework khác.
- Tạo biểu mẫu ở frontend: Đưa schema vào các thư viện như react-jsonschema-form để tự động tạo biểu mẫu giao diện từ mô hình dữ liệu.
- Hợp đồng dữ liệu: Định nghĩa và chia sẻ hợp đồng dữ liệu có cấu trúc giữa các microservice hoặc giữa nhóm frontend và backend.
- Xác thực cấu hình: Xác thực tệp cấu hình JSON trong pipeline CI/CD để bắt lỗi cấu trúc trước khi triển khai.
- Lập kế hoạch di chuyển cơ sở dữ liệu: Ghi lại hình dạng dữ liệu mong đợi khi thiết kế bảng hoặc collection mới.
- Tự động hoàn thành trong IDE: Tham chiếu một JSON Schema trong cài đặt VS Code để bật IntelliSense và xác thực cho tệp JSON tùy chỉnh.
Câu hỏi thường gặp
Công cụ này có miễn phí không?
Có, công cụ tạo JSON Schema hoàn toàn miễn phí, không cần đăng ký và không giới hạn sử dụng. Bạn có thể tạo schema cho bao nhiêu đối tượng JSON tùy ý mà không mất phí.
Dữ liệu của tôi có an toàn không?
Có. Toàn bộ quá trình tạo schema diễn ra trong trình duyệt của bạn. Dữ liệu JSON không bao giờ được gửi đến máy chủ, nên bạn có thể yên tâm dùng với payload API độc quyền hoặc cấu trúc dữ liệu nội bộ.
JSON Schema là gì?
JSON Schema là bộ từ vựng khai báo dùng để chú thích và xác thực tài liệu JSON. Nó mô tả cấu trúc mong đợi, kiểu dữ liệu, thuộc tính bắt buộc và các ràng buộc của một đối tượng JSON. Nó được dùng rộng rãi trong đặc tả API (OpenAPI/Swagger), thư viện tạo biểu mẫu và công cụ xác thực cấu hình.
Tôi nên dùng phiên bản draft nào?
Draft-07 được khuyên dùng cho hầu hết dự án vì đây là phiên bản được hỗ trợ rộng rãi nhất trong các thư viện xác thực và công cụ. Chỉ dùng draft-04 hoặc draft-06 nếu bộ công cụ của bạn yêu cầu cụ thể phiên bản cũ hơn.
Tôi có thể chỉnh sửa schema đã tạo không?
Schema được tạo chỉ là điểm khởi đầu. Sau khi tải về hoặc sao chép, bạn có thể tự thêm các ràng buộc như minLength, maximum, giá trị enum hoặc regex pattern mà không thể suy ra chỉ từ dữ liệu mẫu.
Công cụ có xử lý mảng nhiều kiểu không?
Công cụ suy ra kiểu phần tử mảng từ phần tử đầu tiên. Nếu mảng của bạn chứa nhiều kiểu khác nhau, bạn có thể cần tự chỉnh định nghĩa items thành schema oneOf hoặc anyOf sau khi tạo.
Mẹo và thực hành tốt nhất
- Cung cấp dữ liệu mẫu tiêu biểu: Đưa mọi trường có thể có vào JSON mẫu để schema nắm được toàn bộ cấu trúc.
- Bật mảng required: Bật tùy chọn “required” để bắt buộc các trường thiết yếu khi dùng schema để xác thực.
- Thêm mô tả sau: Bật mô tả giữ chỗ khi tạo, rồi thay bằng tài liệu có ý nghĩa trước khi chia sẻ schema.
- Dùng additionalProperties: false cho API chặt chẽ: Cách này ngăn máy khách gửi các trường ngoài dự kiến có thể gây sự cố ở các bước sau.
- Xác thực sau khi tạo: Kiểm thử schema với nhiều payload mẫu bằng trình xác thực JSON Schema để đảm bảo nó bao phủ các trường hợp biên.
- Quản lý phiên bản schema: Lưu tệp schema trong hệ thống quản lý phiên bản cùng mã API của bạn để theo dõi thay đổi theo thời gian.