服务端 API/应用信息/应用/获取应用版本信息
# 获取应用版本信息

根据应用 ID 和应用版本 ID 来获取同租户下的应用版本的信息

## 请求

基本 |  
---|---
HTTP URL | https://open.larksuite.com/open-apis/application/v6/applications/:app_id/app_versions/:version_id
HTTP Method | GET
接口频率限制 | [100 次/分钟](https://open.larksuite.com/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
支持的应用类型 | Custom App、Store App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用**<br>开启任一权限即可 | 管理应用自身资源(application:application:self_manage)<br>获取应用版本信息(application:application.app_version:readonly)
字段权限要求 | **注意事项**：该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请<br>获取用户 user ID(contact:user.employee_id:readonly)

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：如何选择与获取 access token](https://open.larksuite.com/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)

### 路径参数

名称 | 类型 | 描述
---|---|---
app_id | string | 应用的 app_id，需要查询其他应用版本信息时，必须申请[获取应用版本信息](https://open.larksuite.com/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)权限，仅查询本应用版本信息时，可填入 "me" 或者应用自身 app_id<br>**示例值**："cli_9f3ca975326b501b"
version_id | string | 唯一标识应用版本的 ID<br>**示例值**："oav_d317f090b7258ad0372aa53963cda70d"

### 查询参数

名称 | 类型 | 必填 | 描述
---|---|---|---
lang | string | 是 | 应用信息的语言版本<br>**示例值**："zh_cn"<br>**可选值有**：<br>- zh_cn：中文<br>- en_us：英文<br>- ja_jp：日文<br>**数据校验规则**：<br>- 最小长度：`1` 字符
user_id_type | string | 否 | 用户 ID 类型<br>**示例值**："open_id"<br>**可选值有**：<br>- open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.larksuite.com/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)<br>- union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.larksuite.com/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id)<br>- user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.larksuite.com/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id)<br>**默认值**：`open_id`<br>**当值为 `user_id`，字段权限要求**：<br>获取用户 user ID(contact:user.employee_id:readonly)

## 响应

### 响应体

名称 | 类型 | 描述
---|---|---
code | int | 错误码，非 0 表示失败
msg | string | 错误描述
data | \- | \-
app_version | application.app_version | 应用版本信息
app_id | string | 应用 id
version | string | 在开发者后台填入的应用版本号
version_id | string | 唯一标识应用版本的 ID
app_name | string | 应用默认名称
avatar_url | string | 应用头像 url
description | string | 应用默认描述
scopes | app_scope\[\] | 应用权限列表
scope | string | 应用权限
description | string | 应用权限的国际化描述
level | int | 权限等级描述<br>**可选值有**：<br>- 1：普通权限<br>- 2：高级权限<br>- 3：超敏感权限<br>- 0：未知等级
back_home_url | string | 后台主页地址
i18n | app_i18n_info\[\] | 应用的国际化信息列表
i18n_key | string | 国际化语言的 key<br>**可选值有**：<br>- zh_cn：中文<br>- en_us：英文<br>- ja_jp：日文
name | string | 应用国际化名称
description | string | 应用国际化描述（副标题）
help_use | string | 国际化帮助文档链接
common_categories | string\[\] | 应用分类的国际化描述
events | string\[\] | 应用已订阅开放平台事件列表
status | int | 版本状态<br>**可选值有**：<br>- 0：未知状态<br>- 1：审核通过<br>- 2：审核拒绝<br>- 3：审核中<br>- 4：未提交审核
create_time | string | 版本创建时间（单位：s）
publish_time | string | 版本发布时间（单位：s）
ability | app_ability | 当前版本下应用开启的能力
gadget | gadget | 小程序能力
enable_pc_mode | int | pc 支持的小程序模式，bit 位表示<br>**可选值有**：<br>- 1：sidebar 模式<br>- 2：pc 模式<br>- 4：主导航模式
schema_urls | string\[\] | schema url 列表
pc_use_mobile_pkg | boolean | pc 端是否使用小程序版本
pc_version | string | pc 的小程序版本号
mobile_version | string | 移动端小程序版本号
mobile_min_lark_version | string | 移动端兼容的最低Lark版本
pc_min_lark_version | string | pc 端兼容的最低Lark版本
web_app | web_app | 网页能力
pc_url | string | pc 端 url
mobile_url | string | 移动端 url
bot | bot | 机器人能力
card_request_url | string | 消息卡片回调地址
workplace_widgets | workplace_widget\[\] | 小组件能力
min_lark_version | string | 最低兼容Lark版本号
navigate | navigate | 主导航小程序
pc | navigate_meta | pc 端主导航信息
version | string | 主导航小程序版本号
image_url | string | 默认图片 url
hover_image_url | string | 选中态图片 url
mobile | navigate_meta | 移动端主导航信息
version | string | 主导航小程序版本号
image_url | string | 默认图片 url
hover_image_url | string | 选中态图片 url
cloud_doc | cloud_doc | 云文档应用
space_url | string | 云空间重定向 url
i18n | cloud_doc_i18n_info\[\] | 国际化信息
i18n_key | string | 国际化语言的 key<br>**可选值有**：<br>- zh_cn：中文<br>- en_us：英文<br>- ja_jp：日文
name | string | 云文档国际化名称
read_description | string | 云文档国际化读权限说明
write_description | string | 云文档国际化写权限说明
icon_url | string | 图标链接
mode | int | 云文档支持模式<br>**可选值有**：<br>- 0：未知<br>- 1：移动端
docs_blocks | docs_block\[\] | 云文档小组件
block_type_id | string | BlockTypeID
i18n | block_i18n_info\[\] | block 的国际化信息
i18n_key | string | 国际化语言的 key<br>**可选值有**：<br>- zh_cn：中文<br>- en_us：英文<br>- ja_jp：日文
name | string | 名称
mobile_icon_url | string | 移动端 icon 链接
pc_icon_url | string | pc 端口 icon 链接
message_action | message_action | 消息快捷操作
pc_app_link | string | pc 端链接
mobile_app_link | string | 移动端链接
i18n | message_action_i18n_info\[\] | 国际化信息
i18n_key | string | 国际化语言的 key<br>**可选值有**：<br>- zh_cn：中文<br>- en_us：英文<br>- ja_jp：日文
name | string | 国际化名称
plus_menu | plus_menu | 加号菜单
pc_app_link | string | pc 端链接
mobile_app_link | string | 移动端链接
remark | app_version_remark | 跟随应用版本的信息
remark | string | 备注说明
update_remark | string | 更新说明
visibility | app_visibility | 应用当前版本开发者编辑的可见性建议，若开发者未编辑可见性建议，则该字段无内容
is_all | boolean | 是否全员可见
visible_list | app_visible_list | 可见名单
open_ids | string\[\] | 可见性成员 open_id 列表
department_ids | string\[\] | 可见性部门的 id 列表
group_ids | string\[\] | 可见性成员 group_id 列表
invisible_list | app_visible_list | 不可见名单
open_ids | string\[\] | 不可见性成员 open_id 列表
department_ids | string\[\] | 不可见性部门的 id 列表
group_ids | string\[\] | 不可见性成员 group_id 列表

### 响应体示例
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "app_version": {
            "app_id": "cli_9f3ca975326b501b",
            "version": "1.0.0",
            "version_id": "oav_d317f090b7258ad0372aa53963cda70d",
            "app_name": "应用名称",
            "avatar_url": "https://www.example.com",
            "description": "应用描述",
            "scopes": [
                {
                    "scope": "contact:user.base",
                    "description": "获取应用信息",
                    "level": 1
                }
            ],
            "back_home_url": "https://www.example.com",
            "i18n": [
                {
                    "i18n_key": "zh_cn",
                    "name": "应用名称",
                    "description": "应用描述",
                    "help_use": "https://www.example.com"
                }
            ],
            "common_categories": [
                "分析工具"
            ],
            "events": [
                "应用审核事件"
            ],
            "status": 1,
            "create_time": "1610462759",
            "publish_time": "1610462759",
            "ability": {
                "gadget": {
                    "enable_pc_mode": 1,
                    "schema_urls": [
                        "*:*"
                    ],
                    "pc_use_mobile_pkg": false,
                    "pc_version": "1.0.0",
                    "mobile_version": "1.0.0",
                    "mobile_min_lark_version": "2.0",
                    "pc_min_lark_version": "2.0"
                },
                "web_app": {
                    "pc_url": "https://www.example.com",
                    "mobile_url": "https://www.example.com"
                },
                "bot": {
                    "card_request_url": "https://www.example.com"
                },
                "workplace_widgets": [
                    {
                        "min_lark_version": "1.0.0"
                    }
                ],
                "navigate": {
                    "pc": {
                        "version": "1.0.0",
                        "image_url": "https://www.example.com",
                        "hover_image_url": "https://www.example.com"
                    },
                    "mobile": {
                        "version": "1.0.0",
                        "image_url": "https://www.example.com",
                        "hover_image_url": "https://www.example.com"
                    }
                },
                "cloud_doc": {
                    "space_url": "https://www.example.com",
                    "i18n": [
                        {
                            "i18n_key": "zh_cn",
                            "name": "名称",
                            "read_description": "读权限说明",
                            "write_description": "写权限说明"
                        }
                    ],
                    "icon_url": "https://www.example.com",
                    "mode": 1
                },
                "docs_blocks": [
                    {
                        "block_type_id": "blk_4fb61568435880110854c1d0",
                        "i18n": [
                            {
                                "i18n_key": "zh_cn",
                                "name": "名称"
                            }
                        ],
                        "mobile_icon_url": "https://www.example.com",
                        "pc_icon_url": "https://www.example.com"
                    }
                ],
                "message_action": {
                    "pc_app_link": "https://www.example.com",
                    "mobile_app_link": "https://www.example.com",
                    "i18n": [
                        {
                            "i18n_key": "zh_cn",
                            "name": "名称"
                        }
                    ]
                },
                "plus_menu": {
                    "pc_app_link": "https://www.example.com",
                    "mobile_app_link": "https://www.example.com"
                }
            },
            "remark": {
                "remark": "备注说明",
                "update_remark": "更新说明",
                "visibility": {
                    "is_all": false,
                    "visible_list": {
                        "open_ids": [
                            "ou_1ce003a0f23484806bcab85d2a55a000"
                        ],
                        "department_ids": [
                            "od-ddee42c0f8a948a5e650341e2153243b"
                        ],
                        "group_ids": [
                            "b6d1g5dd6fd26186"
                        ]
                    },
                    "invisible_list": {
                        "open_ids": [
                            "ou_1ce003a0f23484806bcab85d2a55a000"
                        ],
                        "department_ids": [
                            "od-ddee42c0f8a948a5e650341e2153243b"
                        ],
                        "group_ids": [
                            "b6d1g5dd6fd26186"
                        ]
                    }
                }
            }
        }
    }
}
```

### 错误码

HTTP状态码 | 错误码 | 描述 | 排查建议
---|---|---|---
400 | 210503 | invalid app_id | 请检查请求路径中的 app_id 是否合法
400 | 210504 | no such app in tenant | 请检查被查询应用与当前调用接口应用是否在同一企业内
400 | 210505 | target app not a custom app | 请检查被查询应用是否是自建应用
400 | 210506 | no such app | 请检查请求路径中的 app_id 是否存在
400 | 210508 | insufficient permission level | 请检查应用已申请权限与被查询 app_id，当被查询 app_id 非本应用且未申请[获取应用版本信息](https://open.larksuite.com/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)权限时，返回该错误码
400 | 211002 | no such version_id | 请检查路径中的 version_id 是否合法
400 | 211003 | no such version of desired app | 请检查 version_id 是否属于 app_id 对应应用