该错误通常是由于 OpenAPI 中引用了其他文件或链接。可以通过在 Swagger 文件中添加参数 $ref 来引用其他文件和链接。
例如,如果您有一个名为 definitions.json 的文件,其中定义了模式,请按以下方式在 Swagger 文件中添加引用:
"definitions": {
"$ref": "definitions.json"
}
如果您将 API 定义为 API 特定的网址,则还可以使用 URL 引用。例如:
"definitions": {
"$ref": "https://example.com/definitions.json"
}
确保您的文件或链接路径正确,并且可以公开访问。
另外,如果您使用的是自定义连接器,则还需要确保模式定义与您在自定义连接器中创建的定义相匹配。例如:
"definitions": {
"MySchema": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
}
}
}
}
在自定义连接器的'编辑器”选项卡中,您需要为'架构定义”中的每个定义添加相应的定义。
最后,如果您遇到引用文件或链接的问题,请确保您的 OpenAPI 规范是有效的,并且可以成功解析为 JSON 模式。