Nguyên lý hoạt động
Bộ duyệt đệ quy phân tích cả cây Schema lẫn cây dữ liệu JSON, đi sâu qua `properties`, `items`, `allOf`/`anyOf`/`oneOf`, giới hạn số (`minimum`, `maximum`, `exclusiveMinimum`), độ dài/mẫu chuỗi (`minLength`, `pattern`, `format`) và kiểm tra object nghiêm ngặt để trả về chính xác đường dẫn JSON pointer và từ khóa vi phạm.
Hướng dẫn từng bước
Dán định nghĩa JSON Schema của bạn vào khung soạn thảo bên trái.
Dán payload JSON cần kiểm tra vào khung bên phải.
Xem kết quả Đạt/Lỗi tức thì kèm đường dẫn JSON pointer chính xác và từ khóa vi phạm (`type`, `enum`, `additionalProperties`, `minimum`, v.v.).
Sao chép báo cáo lỗi JSON có cấu trúc nếu cần gửi cho đồng đội.
Tính năng nổi bật & Hiệu năng
- Chỉ rõ đường dẫn bị lỗi (`$.items[2].email`) và từ khóa schema không khớp cho từng vi phạm
- Kiểm tra trường bắt buộc `required`, `additionalProperties`, `enum`, `const` và mảng lồng nhau
- Tích hợp sẵn bộ kiểm tra `format` (`email`, `uuid`, `date`, `date-time`, `ipv4`)
- Hỗ trợ tổ hợp `allOf`, `anyOf`, `oneOf` và mẫu regex `pattern` cho chuỗi
- Chạy 100% offline trên trình duyệt: an toàn tuyệt đối cho API nội bộ và dữ liệu webhook khách hàng
Phương pháp tính, Công thức & Tiêu chuẩn
Quá trình xác thực dùng thuật toán duyệt đệ quy tất định trên cây cú pháp AST thay vì sinh mã động (`new Function`), đảm bảo tuân thủ CSP chặt chẽ và không tốn chi phí biên dịch schema.
Tình huống sử dụng thực tế
- Kiểm tra body request webhook hoặc REST API khớp hợp đồng JSON Schema trước khi phát hành client
- Gỡ lỗi file cấu hình JSON / Cloudflare Workers khi vô tình lọt khóa không hợp lệ lên staging
- Thử nghiệm nhanh các trường hợp biên (`null`, số nguyên vs số thực, mảng rỗng) mà không cần viết script Node
- Xuất báo cáo lỗi JSON chuẩn xác để đính kèm vào ticket báo lỗi
Ví dụ minh họa & Trường hợp biên
Strict Object & Format Check
Plan: "enterprise" (enum: free/pro/team), seats: 0 (minimum: 1), extraField: true
$.plan (enum), $.seats (minimum), $.extraField (additionalProperties)
Reports all three distinct violations in one pass instead of stopping at the first error.
UUID & Email Format Validation
{ "id": "550e8400-e29b-41d4-a716-446655440000", "email": "ops@microdeck.tools" } Valid JSON against Schema (0 errors)
Verifies both RFC UUID v1-v8 format and basic email structure.
Lưu ý về giới hạn & Độ chính xác
- • Tính năng tự tải `$ref` từ URL từ xa bị tắt có chủ đích để giữ bảo mật offline; hãy dán trực tiếp schema nội tuyến.
- • Các tính năng đồ thị cực phức tạp của JSON Schema Draft 2020-12 như `$dynamicRef` hoặc `unevaluatedProperties` nằm ngoài phạm vi trình kiểm tra gọn nhẹ này.
Xử lý trực tiếp trên trình duyệt & Bảo mật
Các trang chuyển đổi thông thường tải tài liệu, mã nguồn hoặc video của bạn lên máy chủ từ xa. Kiểm Tra JSON Schema (Draft Validator) chạy hoàn toàn ngay trong tab trình duyệt của bạn:
Nội dung và tệp của bạn được tính toán ngay tại máy, không gửi lên bất kỳ máy chủ xử lý nào.
Microdeck không ghi lại hay lưu trữ tệp và văn bản bạn dán vào công cụ.
Kết quả làm việc chỉ nằm trong bộ nhớ tab hiện tại và tự giải phóng khi bạn đặt lại hoặc đóng tab.
Câu hỏi thường gặp (FAQ)
Công cụ dừng ở lỗi đầu tiên hay báo toàn bộ các lỗi cùng lúc?
Công cụ thu thập và hiển thị toàn bộ đường dẫn bị lỗi trên cả tài liệu JSON để bạn sửa nhiều vấn đề chỉ trong một lần kiểm tra.
`integer` và `number` có được kiểm tra khác nhau không?
Có. `type: "integer"` yêu cầu giá trị phải là số nguyên (`Number.isInteger(val)`, từ chối `1.5`), còn `type: "number"` chấp nhận cả số thập phân.
Tại sao không tự động tải `$ref` qua HTTP?
Các công cụ của Microdeck không bao giờ gửi yêu cầu mạng ra ngoài khi xử lý schema hay payload của bạn, giúp bảo vệ dữ liệu doanh nghiệp nội bộ.
Tôi có thể sao chép danh sách lỗi dưới dạng JSON không?
Có. Bất cứ khi nào xuất hiện lỗi, nút Sao chép báo cáo lỗi sẽ xuất mảng gồm `{ path, keyword, message }`.
Khám phá công cụ liên quan
Chuyển JSON Sang Zod, Pydantic & JSON Schema
Tạo schema kiểm tra dữ liệu Zod, Pydantic và JSON Schema cho LLM ngay trên trình duyệt
Định Dạng JSON, Kiểm Tra Lỗi & Sửa Cú Pháp Tự Động
Làm đẹp, kiểm tra lỗi, so sánh diff và tự sửa JSON sai cú pháp ngay trên trình duyệt
Kiểm Tra Biểu Thức Truy Vấn & Lọc JSONPath
Thử nghiệm bộ chọn RFC 9535 JSONPath, duyệt đệ quy (`..`), wildcard & bộ lọc ngay trên trình duyệt