openapi文档如何处理路径

Question

我有以下网址：

/return/{pid}.xml?d1='123'&d2='345'
/return/{pid}.json?d1='123'&d2='345'

swagger规范要求： 路径：/返回/ {} PID ....

但我如何映射扩展名，即

路径：/return/{pid}.xml

或

路径：/return/{pid}.json

这是一个jersey + spring mvc应用程序 - 所以这两个URL都在同一个控制器上，并且只根据扩展，其余框架将生成xml / json输出。

我无法忽略路径中的扩展名，即： 路径：/return/{pid}

因为用户需要知道他/她必须提供文件扩展名作为URL的一部分。此外，我不能使用对应于xml / json的两个路径，因为它们被应用程序处理相同。另外它会复制一些东西（我不确定是否有类似于c ++ / java“switch”块中的“case”语句的类似机制）

Answer 1

在Swagger规范中，您可以在路径中定义文件扩展名，如下所示：

/return/{pId}.{fileExtension}

并在参数中定义fileExtension。

以下内容也适用（不适用于您的情况）：

/return/pid.{fileExtension}