版本号服务端更新规范 - mindpin/knowledge-space-net-lib GitHub Wiki

版本号响应服务需要能够接收新版本发布请求,将最新的发布包(apk包)以及发布版本号上传到服务器,并且修改版本和里程碑记录。

请求响应格式

  API名称: 新版本应用软件包发布
  使用范围: 运营维护人员使用

  请求:
    url: /api/publish
    请求类型: POST
    参数:
      package: apk包文件体 # 必须。
      version: x.x.x # 必须。此次发布的版本号
      is_milestone: true | false # 可选。该版本是否里程碑版本。当不传时为false

  后台处理:
    调用版本更新记录程序更新版本记录,并将apk包放在阿里云OSS的合适位置上。
    对更新成功或者更新失败都做出响应。

  响应:
    响应类型: JSON
    格式一:
      描述: 版本更新成功,服务端记录已修改
      HTTP status:200
      数据:
        {
          status: 'success'
          newest_version: 'x.x.x'
          newest_milestone: 'x.x.x'
          package_size: xxxx # 单位是字节
        }
    格式二: 
      描述: 版本更新失败,服务端记录没有进行任何修改
      HTTP status:400
      数据:
        {
          status: 'low version' # 要求更新的版本号小于服务端目前的最新版本号
          # 'other' 其他错误
          newest_version: 'x.x.x'
          newest_milestone: 'x.x.x'
        }

后续集成时,该API将被版本发布脚本请求。以更新版本记录。