Trình xác thực JSON Schema

Cách Trình Xác Thực JSON Schema Hoạt Động

Công cụ làm gì

Trình xác thực JSON Schema này kiểm tra dữ liệu JSON theo một JSON Schema (draft-04, draft-06, draft-07 hoặc 2019-09). Nó báo cáo dữ liệu có hợp lệ hay không, và khi không hợp lệ sẽ hiển thị path, keyword và message cho từng lỗi để bạn có thể sửa dữ liệu hoặc điều chỉnh schema.

Các trường hợp sử dụng phổ biến cho lập trình viên

Các nhà phát triển dùng trình xác thực JSON Schema để kiểm thử payload request/response của API, xác thực tệp cấu hình, tạo hoặc gỡ lỗi việc xác thực dựa trên schema trong mã và đảm bảo OpenAPI hoặc các định dạng dựa trên schema khác là chính xác. Nó cũng hữu ích khi xây dựng biểu mẫu hoặc các pipeline ETL dựa vào JSON Schema.

Nhập Schema và Dữ Liệu

Dán hoặc tải JSON Schema của bạn ở một khung và dữ liệu JSON ở khung còn lại. Công cụ sẽ phân tích cả hai và chạy xác thực. Các phiên bản schema được hỗ trợ sẽ được phát hiện từ keyword "$schema". JSON không hợp lệ ở bất kỳ khung nào sẽ được báo trước khi quá trình xác thực chạy.

Các lỗi thường gặp và trường hợp biên

Hãy đảm bảo bản thân schema là JSON hợp lệ và dùng một URL "$schema" được hỗ trợ. Dữ liệu rỗng hoặc không phải object có thể hợp lệ hoặc không hợp lệ tùy theo schema (ví dụ: trường bắt buộc, ràng buộc kiểu). Các lỗi lồng nhau được hiển thị theo ký hiệu path; hãy sửa một lỗi rồi chạy lại để xem các vấn đề còn lại.

Khi nào nên dùng công cụ này thay vì viết mã

Hãy dùng trình xác thực này để kiểm tra nhanh, gỡ lỗi và khám phá schema. Đối với production, hãy chạy xác thực trong ứng dụng của bạn bằng một thư viện như Ajv hoặc tương tự, và đưa schema cùng logic xác thực vào quản lý phiên bản và kiểm thử.