Câu trả lời trực tiếp
JSON Schema mô tả và kiểm tra cấu trúc JSON mong đợi. Công cụ có thể suy luận type và format đã quan sát, nhưng optional field, union và constraint chưa xuất hiện phải được bổ sung bằng kiến thức hợp đồng.
Chọn dialect đích, sinh schema và kiểm tra bằng đúng validator production.
JSON đầu vào
JSON Schema đầu ra
1{2"$schema": "http://json-schema.org/draft-07/schema#",3"type": "object",4"properties": {5"user": {6"type": "object",7"properties": {8"id": {9"type": "integer",10"examples": [11112],13"description": "Id field."14},15"name": {16"type": "string",17"examples": [18"John"19],20"description": "Name field."21},22"email": {23"type": "string",24"format": "email",25"examples": [26"[email protected]"27],28"description": "Email field."29},30"isActive": {31"type": "boolean",32"examples": [33true34],35"description": "IsActive field."36},37"roles": {38"type": "array",39"items": {40"anyOf": [41{42"type": "string",43"examples": [44"admin"45]46},47{48"type": "string",49"examples": [50"editor"51]52}53]54},55"examples": [56[57"admin",58"editor"59]60],61"description": "Roles field."62},63"profile": {64"type": "object",65"properties": {66"age": {67"type": "integer",68"examples": [693070],71"description": "Age field."72},73"address": {74"type": "object",75"properties": {76"city": {77"type": "string",78"examples": [79"New York"80],81"description": "City field."82},83"zip": {84"type": "string",85"examples": [86"10001"87],88"description": "Zip field."89}90},91"required": [92"city",93"zip"94],95"description": "Address field."96}97},98"required": [99"age",100"address"101],102"description": "Profile field."103},104"lastLogin": {105"type": "string",106"format": "date-time",107"examples": [108"2024-03-18T10:24:00Z"109],110"description": "LastLogin field."111},112"homepage": {113"type": "string",114"format": "uri",115"examples": [116"https://example.com"117],118"description": "Homepage field."119}120},121"required": [122"id",123"name",124"email",125"isActive",126"roles",127"profile",128"lastLogin",129"homepage"130],131"description": "User field."132}133},134"required": [135"user"136]137}
Cách sử dụng
- Dán/tải JSON hoặc lấy mẫu công khai được hỗ trợ.
- Chọn JSON Schema draft; đặt type mapping, description, example, required, const và null.
- Xem raw/tree, chạy bằng validator đích rồi sao chép hoặc tải schema.
Tính năng và thiết lập chính
- Chọn các draft cũ đến 2020-12 trong giao diện hiện tại.
- Type mapping smart/strict/loose.
- Tùy chọn description, example, required, const và null.
- Xem raw schema và cây cấu trúc để review.
Đầu vào và đầu ra được hỗ trợ
Đầu vào: văn bản hoặc tệp JSON, URL công khai được hỗ trợ. Đầu ra: văn bản hoặc tệp JSON Schema.
Trường hợp sử dụng
- Khởi tạo validation cho request/response API.
- Mô tả fixture hoặc dữ liệu export.
- Tạo schema ban đầu cho UI generation hay contract test.
Nên chọn workflow nào?
Dùng Công cụ sinh JSON Schema từ JSON khi cần: Chọn các draft cũ đến 2020-12 trong giao diện hiện tại. Dùng Công cụ sinh Function Calling Schema từ JSON khi cần: Target đang hiển thị: OpenAI, Claude và Gemini.
Quyền riêng tư và luồng dữ liệu
Trong implementation hiện tại, dữ liệu dán/tải tệp được xử lý trong trình duyệt; riêng “Extract from URL” dùng proxy phía máy chủ để lấy nguồn.
Giới hạn và xử lý lỗi
- OpenAPI 3.1 dùng ngữ nghĩa JSON Schema Draft 2020-12; hãy chọn đúng dialect mà toolchain đích hỗ trợ.
- Một mẫu khiến mọi property đang có trông như required; cần nhiều mẫu và hiểu biết contract.
- UI hiện tại hiển thị giới hạn đầu vào 5 MB.
FAQ
Nên chọn JSON Schema draft nào?
Chọn dialect mà validator hoặc nền tảng đích thực sự yêu cầu. Draft 2020-12 là phiên bản JSON Schema đã công bố mới nhất, nhưng hệ thống cũ có thể cần draft trước.
Dữ liệu có được tải lên máy chủ không?
Trong implementation hiện tại, dữ liệu dán/tải tệp được xử lý trong trình duyệt; riêng “Extract from URL” dùng proxy phía máy chủ để lấy nguồn.
Giới hạn tệp hoặc dữ liệu là bao nhiêu?
UI hiện tại hiển thị giới hạn đầu vào 5 MB.
Có dùng được trên điện thoại không?
Trang là công cụ web và có thể chạy trên trình duyệt di động hiện đại, nhưng hành vi chọn tệp, bộ nhớ và khả năng tương thích chưa được xác minh trên mọi thiết bị. Nên dùng desktop với dữ liệu lớn hoặc phức tạp.
Nên chọn workflow nào?
Dùng Công cụ sinh JSON Schema từ JSON khi cần: Chọn các draft cũ đến 2020-12 trong giao diện hiện tại. Dùng Công cụ sinh Function Calling Schema từ JSON khi cần: Target đang hiển thị: OpenAI, Claude và Gemini.
Công cụ liên quan
Chọn dialect đích, sinh schema và kiểm tra bằng đúng validator production.