如何将openAPI规范中的bitbucket中的资源设置为$ref(URL引用)



我们可以在openAPI规范中设置$ref:'Some Bitbucket URL'吗?如果是此外,如何为bitbucket添加所需的用户名和密码。已在下面尝试,但不起作用$ref:'https://username:password@resourceURL#/difinitions/nameOfTheComponent。

我们需要做什么额外的更改来访问URL访问比特桶URL参考吗?https://swagger.io/docs/specification/using-ref/没有关于为url添加用户名密码的信息。

您可以使用原始链接引用公共Bitbucket存储库中的文件。原始文件链接有以下格式(假设您使用bitbucket.org(:

https://bitbucket.org/<OWNER>/<REPO>/src/<BRANCH_NAME or HEAD or COMMIT_SHA>/<PATH_TO_FILE>

例如,您可以将该文件中的Pet模式引用为:

$ref: 'https://bitbucket.org/atlassian/swagger-request-validator/raw/master/swagger-request-validator-core/src/test/resources/oai/v3/pet.yaml#/components/schemas/Pet'

您不能引用私有Bitbucket repos中的文件。这是因为对私有Bitbucket存储库的编程访问需要身份验证,而$ref没有提供身份验证凭据的机制。

最新更新