我正在看一个显示这个的Swagger UI:
我不知道 {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}
段表示的可能解释(它看起来像路径模板) . 现在我想肯定地知道 .