在 Swagger (OpenAPI 3.0) 的路径参数中使用分号 (;)

Ami*_*aki 5 url url-parameters swagger swagger-ui openapi

我想为一些OSRM API编写一个 swagger API 文档。有一个coordinates路径参数是:

格式为 {longitude},{latitude};{longitude},{latitude}[;{longitude},{latitude} ...] 的字符串。

例如:51.3462,32.5280;51.3452,32.5280;51.3619,32.5236

如何使 OpenAPI 3.0 中的这种格式不进行百分比编码?

允许使用分号(;),Query Parameters我们可以使用 allowReserved: true,但它在路径参数中不可用。

还有另一种选择是使用数组并利用序列化来使用style: matrix,但它有助于对象成为例如/point;x=20;y=30不是数组的对象。例如,它使数组/users/;id=3,4,5not /users/id=3;4;5

有什么解决方案可以用分号而不是逗号来序列化数组吗?或者让类型为字符串并包含分号?