本文是對(duì)http://json-schema.org/ 首頁(yè)的翻譯
JSON Schema
JSON Schema 是一個(gè)允許你標(biāo)注和驗(yàn)證JSON文檔的詞匯。
優(yōu)點(diǎn)
JSON Schema
- 描述你的已經(jīng)存在的數(shù)據(jù)格式
- 清晰,人工和機(jī)器都能閱讀的文檔
- 完整的結(jié)構(gòu)驗(yàn)證,有利于
- 自動(dòng)測(cè)試
- 驗(yàn)證客戶端提交的數(shù)據(jù)
JSON Hyper-Schema
- 描述已經(jīng)存在的API——不需要新的結(jié)構(gòu)
- 鏈接(為木匾URIs包含URI Templates)
- 格式化——為需要的數(shù)據(jù)指定一個(gè)JSON Schema
快速入門(mén)
被驗(yàn)證或描述的JSON文檔稱作實(shí)例,包含描述信息的文檔被稱為模式(schema).
最基本的一個(gè)模式是一個(gè)空白的JSON對(duì)象,沒(méi)有包含任何東西。它允許任何東西止后,沒(méi)有任何描述。
{}
你可以通過(guò)添加一個(gè)驗(yàn)證的關(guān)鍵字到模式中實(shí)現(xiàn)對(duì)一個(gè)實(shí)例應(yīng)用限制條件溜腐。例如译株,"type"關(guān)鍵字可以用用限制一個(gè)實(shí)例到指定的對(duì)象、數(shù)組挺益、字符串歉糜、數(shù)值、布爾或null:
{ "type": "string" }
JSON Schema是一個(gè)成熟的超媒體望众,并且完美的適用于注解你的基于JSON的 HTTP API匪补。JSON Schema文檔被URIs識(shí)別,用在Http鏈接的頭部信息烂翰。并且內(nèi)部的JSON Schema文檔可以被嵌套的循環(huán)使用夯缺。
更多信息
有興趣嗎?參考:
- 特性
- 部分示例
- 來(lái)自Space Telescope Science Institute, 模式作者的優(yōu)秀指引
- 正在增長(zhǎng)的JSON (Hyper-)Schema 軟件
有任何問(wèn)題甘耿?感覺(jué)非常有用踊兜?通過(guò)以下方式參與: