https://hugozh.cn/functions/openapi3/ Recent content in OpenAPI 函数 on Hugo 中文文档 Hugo zh-cn Fri, 02 Oct 2026 01:21:54 +0800 https://hugozh.cn/functions/openapi3/unmarshal/ Fri, 02 Oct 2026 00:00:00 +0800 https://hugozh.cn/functions/openapi3/unmarshal/ <h2 id="用法">用法</h2> <p>传给 <code>openapi3.Unmarshal</code> 函数的资源必须是 <a href="https://swagger.io/specification/#openapi-document" target="_blank" rel="noopener">OpenAPI 文档</a>，通常是 JSON 或 YAML 格式。这个资源可以是<a href="https://hugozh.cn/quick-reference/glossary/global-resource/">全局资源</a>，也可以是<a href="https://hugozh.cn/quick-reference/glossary/remote-resource/">远程资源</a>。</p> <p>该函数会自动解析并纳入所有外部引用（本地与远程都包括），返回一份完整的 <a href="https://swagger.io/specification/#openapi-description" target="_blank" rel="noopener">OpenAPI 描述</a>，完整描述某个 API 的对外接口及其语义。</p>