- JSON Schema là gì và vì sao nên dùng?
- JSON Schema là bộ từ vựng để chú thích và xác thực tài liệu JSON. Nó mô tả cấu trúc dữ liệu, ràng buộc và quy tắc bằng chính định dạng JSON. Lợi ích gồm: tự động kiểm tra dữ liệu, tài liệu API rõ ràng, hỗ trợ sinh mã, cải thiện trải nghiệm dev và phát triển dựa trên hợp đồng. JSON Schema được dùng rộng rãi trong thiết kế API, kiểm tra cấu hình và tạo biểu mẫu.
- Công cụ có tạo schema từ mọi JSON không?
- Có. Công cụ phân tích bất kỳ JSON hợp lệ nào và sinh schema tương thích Draft-07. Nó xử lý đầy đủ các kiểu: đối tượng, mảng, chuỗi, số, boolean và null; suy luận kiểu, trường bắt buộc và mẫu cơ bản từ dữ liệu mẫu. Với trường hợp phức tạp, bạn có thể cần tinh chỉnh thêm schema.
- Schema sinh ra chính xác tới mức nào?
- Schema được sinh dựa trên dữ liệu mẫu nên nhận diện đúng kiểu và cấu trúc, nhưng ràng buộc được giả định ở mức an toàn. Ví dụ, công cụ không thể biết số phải dương hay chuỗi phải tuân theo pattern cụ thể nếu điều đó không xuất hiện trong mọi mẫu. Hãy luôn rà soát và bổ sung quy tắc đặc thù miền nghiệp vụ.
- Có thể dùng schema sinh ra để xác thực không?
- Hoàn toàn được. Schema tạo ra tương thích với các trình xác thực JSON Schema như Ajv, joi hoặc json-schema library. Bạn có thể dùng để kiểm tra request/response API, tệp cấu hình hay dữ liệu đầu vào. Schema tuân theo đặc tả Draft-07 và tích hợp tốt với Node.js, Python, Java hoặc bất kỳ ngôn ngữ nào hỗ trợ JSON Schema.
- Khác biệt giữa các bản Draft JSON Schema là gì?
- JSON Schema phát triển qua nhiều Draft (Draft-04, Draft-06, Draft-07, 2019-09, 2020-12). Công cụ sinh schema Draft-07 vì phổ biến và ổn định. Điểm khác biệt: Draft-07 bổ sung if/then/else, Draft 2019-09 giới thiệu hệ từ vựng và $recursiveRef, Draft 2020-12 thêm $dynamicRef và unevaluatedProperties. Với đa số trường hợp, Draft-07 đáp ứng tốt cả tính năng lẫn khả năng tương thích.