x-codeSamples 扩展将代码示例添加到 OpenAPI 规范中,并在 OpenAPI 页面中展示它们。
该属性可添加到任何请求方法,并具有以下结构。
string
必填
代码示例所使用的语言。
string
示例的标签。在为同一端点提供多个示例时很有用。
string
必填
示例的源码。
在 API 端点旁展示特定语言的代码示例,向开发者演示如何使用你的 SDK
x-codeSamples 扩展将代码示例添加到 OpenAPI 规范中,并在 OpenAPI 页面中展示它们。
该属性可添加到任何请求方法,并具有以下结构。