OTA升级

API的文档位于 https://dev.izhiju.cn/api/doc/

该文档可通过Swagger UI获得,极大地帮助测试和探索公开的服务。

为了通过API访问REST资源,需要一个身份验证令牌。幸运的是,可以通过执行身份验证API轻松获取令牌。有几种方法可以调用API,一种简单的方法是使用Swagger UI:

  • 用户名:text 密码:xxxx
  • 二维码 (传入设备参数scene_id参数必须是9位int整数,生成的二维码为临时二维码有效期30天,具体调用操作如下)
  • 用户登录接口请查看:用户接口

1. OTA升级接口

  • 参数: * 调用生成二维码接口 * deviceid: 设备id (添加限制) * version: 版本 (输入 “0” 获取最大的版本) * package: 包名 (必传) * scopeId: 登录用户获取

请求成功: 返回json数据:

  • 调用生成二维码接口

2. Admin 用户使用说明

登陆网址:https://dev.izhiju.cn/admin/

1.首页:页面各区域功能如图中所批注

  • 调用生成二维码接口
  1. 用户模块:该模块分上下两部分。在上部分:可以在这个模块里面对用户进行操作,有搜索(查询),添加,修改(编辑),删除;在下部分:此部分需要先选中上面的任一用户,Description是对该用户的一些描述,Credentials是指用户的密码,只有Credential Type的值为PASSWORD才是指用户登陆输入的密码,其他类型是用户的其他登陆方式的密码(预留扩展部分),在这部分里可以对密码增改删操作。
  • 调用生成二维码接口
  1. 版本管理模块:该模块分成上下两部分,上面是指各个固件,可对进行增删改查操作,下面是指各个固件的版本(需要先点击任一固件,才会出现版本),也可进行增删改查操作。
  • 调用生成二维码接口

    特别注意,包名是硬件的唯一标识,固件包名一般以 ota.system. 开头,加上android发布时自定义的型号, 版本信息中的版本区分大小写,需要完全按照固件提供方给出的版本信息填写。 版本类型中 all代表全量升级包,patch是差分包。 版本说明将会显示在升级界面上,需要注意分行格式,确保在相框上显示正常。