新建Azure API管理服务导入指定URL提示无效,请求排查原因
为什么你导入的URL会提示无效?
你碰到的问题核心很明确:你复制的http://conferenceapi.azurewebsites.net?format=json是API的实际数据返回端点,它返回的是会议列表的JSON业务数据,而不是Azure API Management要求的OpenAPI(Swagger)规范文件。
APIM导入API时,需要的是描述API结构、端点、参数、响应格式的标准化规范文档(通常是.json或.yaml格式的OpenAPI文件),而不是直接返回业务数据的API调用地址,这就是系统报错「Please specify valid OpenAPI specification file」的原因。
快速解决方法
这个会议API本身自带了标准的OpenAPI规范,你可以替换成下面这个地址进行导入:http://conferenceapi.azurewebsites.net/swagger/v1/swagger.json
操作步骤:
- 回到APIM的导入页面,把原来的URL替换成上面的规范地址
- 点击导入,系统就能正常识别并加载API的完整定义了
另外你可能是混淆了教程里的步骤——那个带format=json的URL,大概率是后续测试API调用时需要用到的地址,而非导入阶段的规范文件地址哦。
内容的提问来源于stack exchange,提问作者Kirsten
相关产品推荐
相关产品推荐

