# 静默升级第三方应用
表1静默升级第三方应用 
| **REST URL格式** |     **访问方法**      |                                                                                                                                                                                            **URI**                                                                                                                                                                                            ||||
| **REST URL格式** |
|---|---|---|---|---|---|
| POST           | ~https://ip/v1/extend/app/upgrade~                                                                                                 ||||
| **接口功能**       | 静默升级第三方应用                                                                                                                                                                                                                                                                                                                                                                                                        |||||
| **接口说明**       | 用于静默升级第三方应用                                                                                                                                                                                                                                                                                                                                                                                                      |||||
| **响应数据**       | 参见[表 返回值]，[表 error]                                                                                                                              |||||
| **参数**         | **参数名称**          | **可选/必选/条件必选** | **参数类型**                                                                                | **位置** | **参数说明**                                                                                                                                                                                                                                                                     |
| **参数**         | packageName       | 必选             | 字符串                                                                                     | 无      | 升级包的文件名。 文件名的命名字符只能包括字母、数字、"."（点）、"_"（下划线）和"-"（连字符），且不能以"."（点）开头，文件名长度不超过100个字符。                                                                                                                   |
| **参数**         | startAfterInstall | 可选             | int 取值为0或者1 | 无      | 升级完成后是否启动应用 "0"表示不启动应用。 "1"表示启动应用。 默认为"0"。 |
| **请求消息**       | Header: Cookie: SessionID=xxx Content-Type: application/json; charset=UTF-8 X-Access-Token: xxx Body: { "packageName": "test.apk", "startAfterInstall": 0 } |||||
| 备注             | 升级包需放在/sdcard/Download/目录下。待升级的第三方应用必须在AndroidManifest.xml文件中使用名称为" com.device.permission.THIRDAPP_UPGRADE_SILENT"的（静默升级）权限，并前往"高级设置 \> 应用管理 \> 权限管理 \> 允许安装应用"和"高级设置 \> 应用管理 \> 应用权限 \> 待升级APP \> 静默升级"开启权限才可以进行升级。                                                                                                                                                                                             |||||
   
 表2返回值 
| 参数      | 类型     | 取值范围     | 参数说明                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| success | int    | \[0, 1\] | 响应结果 0：失败 1：成功                                                                                      |
| data    | Object | 可选， 空对象  | 成功返回数据。这里返回空。 例如：{"success":1,"data":""}                                                                                                                                                                                     |
| error   | Object | 可选       | 失败返回错误信息。参见[表 error] 例如：{"success":0,"error":{"id":100666744,"code":134250502,"params":\[\]}} |
   
 表3error 
| 参数    | 类型     | 取值范围     | 参数说明                                                                                                                    |
|:---|:---|:---|:---|
| id    | int    | 32位整数    | 错误id，用于转换。                                                                                                              |
| code  | int    | 32位整数    | 错误码，跟错误id对应，具体含义参考[错误码](https://support.huaweicloud.com/ideahub-api/ideahub_05_0255.html#ZH-CN_TOPIC_0000001309671920)。 |
| param | Object | param 对象 | 失败响应的附带参数。                                                                                                              |