openapi 3中有自定义属性吗？

Question

我们有php-swagger，它以开放的api 3.0格式生成开发人员文档。

有一项任务--基于生成的api-docs.json编写其他文档，用于数量有限、静态的客户端(没有发送请求的能力)。只需制作一个精简的新openapi3.0格式的json文件

结果是，您需要在代码中以某种方式标记注释，这些注释是其他文档的注释。并创建一个新的json文件。

问题是，我不知道如何在php代码中在注释级别标记路由，这样在路由描述中就会有一些特性，因此我可以解析api-docs.json并从中提取路由。

Answer 1

您可以使用供应商扩展https://zircote.github.io/swagger-php/guide/common-techniques.html#vendor-extensions

这些都是标准的一部分，但是被忽略了，所以你可以以任何你喜欢的方式使用它们。