原生 HTTP 接口

这些是当前服务实际注册的 HTTP 路由，和 protobuf 的 REST 注解分开。普通设备登记、订阅、下行及组播使用 LoRaWAN API。

查询系统更新状态

GET /api/alinkwise/updates。平台管理员登录 JWT，Header 为 authorization: Bearer <token>。无请求字段。返回原生管理器的 update-status JSON，具体状态和结果以当前管理器版本为准。

检查系统更新

POST /api/alinkwise/updates/check。同上鉴权，无请求字段。触发原生管理器 update-check，会访问所配置发布源；并非只读取本地缓存。

提交系统更新

POST /api/alinkwise/updates/start。需要平台管理员用户登录态，不允许仅持有 API Key 替代用户。Content-Type 为 application/json。

名称	类型	必填	说明
version	string	是	三段点分十进制版本，长度不超过 64 字符
sha256	string	是	检查更新得到的安装包摘要，64 个 HEX 字符

不接受未知字段。返回原生管理器 update-start 的 JSON；已提交不是安装成功，需要继续查询状态。不要凭手填的版本和摘要跳过发布源校验。

更新接口错误

错误体为含 error 字符串的 JSON。401 表示缺失/失效凭据；403 表示非平台管理员用户；400 表示参数或管理器执行失败；429 表示更新操作繁忙；503 表示未接入原生管理器或管理器不可用；504 表示调用超时；500 表示返回格式异常。JSON 解析层也可能因请求格式错误拒绝请求。

当前开发环境未配置 ALINKWISE_NATIVE_ROOT，查询会报告不支持在线更新；不是下载或升级成功。正式更新要求原生部署、签名、公钥与服务任务都满足条件。

网关升级文件下载

GET /api/alinkwise/gateway-upgrades/{file_name}。供网关拉取服务器已准备好的升级文件，不是用户任意文件下载接口。file_name 由远程升级准备流程生成，不应自行拼接或枚举。文件不存在、名称不合法或环境不满足时返回相应 HTTP 错误。

响应为升级文件字节；文件已下载不表示网关安装成功。升级后的版本和配置需重新读取确认。准备和提交升级使用 AlinkwiseService/UpgradeGatewayRemote，完整参数见平台扩展。