HERE Routing API v8.27.0 OpenAPI规范无效及导入报错咨询

故障现象 #

• 使用Visual Studio 2019的OpenAPI Service Reference功能导入HERE Routing API规范文件时操作失败，返回错误码-1
• 修复引用错误后可成功导入并生成相关类，但项目构建阶段抛出Price类未定义的编译错误

问题排查与临时修复方案 #

经多款API规范校验工具排查，确认故障由规范文件本身的格式错误导致：

• 第272行引用格式错误
  • 原错误内容：LineString: "../shared/common.yaml#/components/schemas/LineString"
  • 临时修复方法：将外部相对路径引用改为当前文档内引用，修改为LineString: "#/components/schemas/LineString"，修改后即可完成规范导入与类生成操作
• 缺失Price类定义
  规范文件未声明Price类的相关结构，属于规范本身的定义疏漏，目前无通用临时修复方案，需官方补充完善对应定义。

后续建议 #

该OpenAPI规范文件存在多处不符合标准的格式问题，请官方对规范进行全量校验并修复相关错误。

内容的提问来源于stack exchange，提问作者micieb