如何获取Azure IoT Hub设备相关操作的OpenAPI规范？

你要找的设备相关操作OpenAPI规范没有直接在REST API文档页提供显眼的下载入口，可以通过下面两个可靠渠道获取，都能直接适配autorest的代码生成要求：

• 优先用官方SDK同源的规范文件：Azure官方维护的公共REST API规范仓库里，收录了IoT Hub所有稳定版API的OpenAPI定义，完整覆盖设备身份增删改查、设备孪生读写、直接方法调用、设备条件查询等文档列出的全部设备相关接口，这也是官方生成各语言SDK时直接引用的源文件，没有字段缺失、接口定义偏差的问题。你在仓库里找到iothub服务分类下的iothub.json即可，推荐选2020-03-01及之后的稳定版本，接口覆盖最完整。
• 按需提取单模块规范：如果不需要全量IoT Hub服务API，只需要设备相关的接口定义，可以直接从对应REST API文档页提取：打开设备操作列表的文档页，按F12调出浏览器开发者工具，切到网络面板筛选openapi相关请求，页面加载时会自动拉取对应接口的OpenAPI片段，把响应内容保存成本地JSON文件就能用。

用autorest生成Golang客户端的注意事项：

• 提前安装3.x及以上版本的autorest，2.x低版本对Go SDK的生成逻辑有已知兼容问题，会生成无法正常调用的代码
• 基础生成命令可以参考：

autorest --go --use=@autorest/go@latest --input-file=<本地OpenAPI文件的绝对路径> --output-folder=./iothub-device-client --namespace=iothub

• 如果用自己从页面提取的片段文件生成时遇到模型引用报错，可以在命令末尾加--skip-validation参数跳过规范校验；官方全量规范文件一般不会触发这类问题，优先推荐用官方全量文件。

避坑提醒：不要用第三方站点流传的2020年之前的旧版IoT Hub Swagger文件，这类旧文件没更新新版接口的鉴权规则，生成的客户端调用接口时大概率返回401无权限错误。

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