我正在看一个显示这个的Swagger UI:

enter image description here

我不知道 {format} "segment"是什么或它是什么 . 我想也许这与piece of Swagger documentation(在"Data Types" Headers 下)有关:

基元具有可选的修饰符属性格式

但是,我相信我已经在我自己的swagger.json内容中找到了这个 format 修饰符,它肯定没有出现在我的招摇UI中 . 例如,我的swagger.json经常包含这个:

operationId“:”ApiValuesByIdGet“,”生成“:[],”参数“:[{”name“:”id“,”in“:”path“,”required“:true,”type“:”integer“ “格式”: “INT32”}]

那么为什么上面这张图片中的“有趣的商业”呢?

我被告知提供API的 endpoints 是用Ruby或Grape编写的 . 此外,它返回的swagger.json显示它是SwaggerVersion 1.2 .

我注意到Swagger UI在右下角也显示错误 . 当我选择错误链接时,它会显示详细信息:

{“schemaValidationMessages”:[{“level”:“error”,“message”:“弃用的Swagger版本 . 有关升级到Swagger 2.0的信息,请访问http://swagger.io”}}}}

我不知道这个错误是否相关 .

最后,我只是想知道 {format} 段表示的可能解释(它看起来像路径模板) . 现在我想肯定地知道 .