如何在另一個 API 中引用 Swaggerhub 上的 API？

Question

引用域時，您將使用以下命令從 CommonDomain 域中獲取 CommonSchema model

$ref: 'https://api.swaggerhub.com/domains/CompanyName/CommonDomain/1.0.0#/components/schemas/CommonSchema'

您如何引用另一個現有的 api？ 這是通過 Swaggerhub 中的另一個 API 完成的。 當我嘗試做這樣的事情來獲得 SomeSchema model

$ref: 'https://api.swaggerhub.com/apis/CompanyName/SomeApi/1.0.0#/components/schemas/SomeSchema'

我收到一條錯誤消息，提示它無法解析引用：404 Unknown Domain CompanyName/SomeApi:1.0.0

這對於生成 swagger 代碼生成是合法的。 這只是 swaggerhub 的限制嗎？ 如果沒有，一個 go 如何正確地做到這一點？

Answer 1

SwaggerHub 中不存在此功能。 您只能從 SwaggerHub 中的域文件引用 object，而不是 API 文件。

這就是我的想法：

域文件中的任何 object 都可以被任何其他文件（在同一組織內）引用。

具有 API 文件的對象只能在同一文件中引用。