const schema = {
$schema: 'http://json-schema.org/draft-04/schema#',
type: ['string', 'null'],
format: 'date-time',
};

console.log(toOpenApi(schema));

該示例打印出:

{
type: 'string',
format: 'date-time',
nullable: true
}

請記住,此包基于JSON Schema v5.0 – 因此請確保您使用該版本或更高版本。

總結

OpenAPI v3.0 既是 JSON Schema Draft 5 的子集,又是超集,這讓開發人員感到困惑。

換句話說,未來仍然存在分歧,但正在越來越近。根據上述拉取請求中的討論,以下是仍需在 OpenAPI v3.1 中支持的 JSON Schema 2019-09 關鍵字:

此外,還有關于 exclusiveMinimum 和 exclusiveMaximum 使用的說明。如需深入了解,您可以閱讀 Phil關于該主題的文章。他深入探討了架構和規范之間的具體差異。主要目標是在 OpenAPI 3.1 中編寫標準 JSON Schema,而不會出現奇怪的錯誤。不再需要變通方法或轉換。

此外,工具供應商將能夠使用 JSON Schema 驗證器來替換他們在項目“OpenAPI 友好”版本中用作占位符的任何快速修復 OpenAPI 驗證器。

如果在實施這一想法的過程中沒有出現意外問題,我們將看到該提案作為 OpenAPI v3.1 中的一個功能出現,并朝著徹底解決“分歧”問題邁出又一步。

原文鏈接:OpenAPI and JSON Schema: When to Use Which

上一篇:

揭秘API優先策略:構建高效應用的全新方法

下一篇:

三種用戶通信 API 類型及其應用場景
#你可能也喜歡這些API文章!

我們有何不同?

API服務商零注冊

多API并行試用

數據驅動選型,提升決策效率

查看全部API→
??

熱門場景實測,選對API

#AI文本生成大模型API

對比大模型API的內容創意新穎性、情感共鳴力、商業轉化潛力

25個渠道
一鍵對比試用API 限時免費

#AI深度推理大模型API

對比大模型API的邏輯推理準確性、分析深度、可視化建議合理性

10個渠道
一鍵對比試用API 限時免費