Rest OpenAPI:OpenAPI文档的标准位置和名称

Rest OpenAPI:OpenAPI文档的标准位置和名称,rest,swagger,openapi,Rest,Swagger,Openapi,我正在查看OAS,可以看到推荐的文件名为openapi.json,但我有两个问题: 有证据表明没有一个标准的位置来放置它,但有一个事实上的标准,人们似乎遵循?类似的假设是,在/openapi.json下,最“正常”的访问位置是什么 为什么规范中没有提到这一点,为什么仅仅推荐文档名而不是必需的?这不是为了让它被发现吗?重新定位OpenAPI文档似乎是通过给你一些你必须知道的东西来克服这一点。但是,把它排除在外有什么好处吗 相关(或重复):。OpenAPI规范库中的相关讨论:,所以这个问题看起来

我正在查看OAS,可以看到推荐的文件名为
openapi.json
,但我有两个问题:

  • 有证据表明没有一个标准的位置来放置它,但有一个事实上的标准,人们似乎遵循?类似的假设是,在
    /openapi.json
    下,最“正常”的访问位置是什么

  • 为什么规范中没有提到这一点,为什么仅仅推荐文档名而不是必需的?这不是为了让它被发现吗?重新定位OpenAPI文档似乎是通过给你一些你必须知道的东西来克服这一点。但是,把它排除在外有什么好处吗


  • 相关(或重复):。OpenAPI规范库中的相关讨论:,所以这个问题看起来已经过时了(原始海报似乎已经编辑过,基本上是说不使用答案)。阅读github的问题,尽管目前这似乎是一个公开的问题。我看到两种不同的方式提到将它放在API的基本目录中(即
    /API
    /v2
    ,等等),我看到在站点的
    /
    目录中提到了API.json。所以我想我对我的#2但我的#1(如果我是对的话)有一些答案社区似乎还没有做出决定。另一条评论似乎也引用了RFC8631,它没有标准化(显然纯粹是“信息性的”),至少我的flask restplus api没有设置此
    服务描述
    响应头。