Swagger UI {format}属性？

Question

我正在查看显示此内容的Swagger UI：

我不知道{format}＆＃34;段＆＃34;是或是什么。我想也许这与piece of Swagger documentation有关（在＆＃34;数据类型＆＃34;标题下）：

  

基元有一个可选的修饰符属性format

但是，我相信我已经在我自己的swagger.json内容中找到了这个format修饰符，它肯定不会出现在我的招摇UI中。例如，我的s​​wagger.json经常包含这个：

  

operationId＆＃34;：＆＃34; ApiValuesByIdGet＆＃34;＆＃34;产生＆＃34;：[]，＆＃34;参数＆＃34;：[{＆＃34;名称＆＃34;：＆ ＃34; ID＆＃34;＆＃34;在＆＃34;：＆＃34;路径＆＃34;＆＃34;需＆＃34;：真，＆＃34;类型＆＃34;：＆＃34;整数＆＃34;＆＃34;格式＆＃34;：＆＃34; INT32＆＃34;}]

为什么＆＃34;有趣的生意＆＃34;在上图中？

我告诉说，提供API的端点是用Ruby或Grape编写的。此外，它返回的swagger.json显示它是SwaggerVersion 1.2。

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

  

{＆＃34; schemaValidationMessages＆＃34;：[{＆＃34; level＆＃34;：＆＃34; error＆＃34;，＆＃34; message＆＃34;：＆＃34;弃用的Swagger版本。有关升级到Swagger 2.0的信息，请访问http://swagger.io \＆＃34;＆＃34;}]}

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

最后，我只是想知道{format}段表示什么的可能解释（它看起来像路径模板）。现在我认为它是格格不入的swagger.json，但我想肯定地知道。