# 查看待审核的应用列表

查看本企业下所有待审核的自建应用列表

## 请求

基本 | &nbsp;
---|---
HTTP URL | https://open.feishu.cn/open-apis/application/v6/applications/underauditlist
HTTP Method | GET
接口频率限制 | [特殊频控](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
支持的应用类型 | Custom App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 获取应用信息(admin:app.info: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.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)

### 查询参数

名称 | 类型 | 必填 | 描述
---|---|---|---
lang | string | 是 | 指定返回的语言<br>**示例值**：zh_cn<br>**可选值有**：<br>- zh_cn：中文<br>- en_us：英文<br>- ja_jp：日文<br>**数据校验规则**：<br>- 最小长度：`1` 字符
page_token | string | 否 | 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果<br>**示例值**：new-e3c5a0627cdf0c2e057da7257b90376a
page_size | int | 否 | 分页大小<br>**示例值**：10<br>**默认值**：`20`<br>**数据校验规则**：<br>- 最大值：`50`
user_id_type | string | 否 | 用户 ID 类型<br>**示例值**：open_id<br>**可选值有**：<br>- open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)<br>- union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/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.feishu.cn/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 | \- | \-
items | application\[\] | 待审核应用列表
app_id | string | 应用的 app_id
creator_id | string | 应用创建者（所有者）
status | int | 应用状态<br>**可选值有**：<br>- 0：停用状态<br>- 1：启用状态<br>- 2：未启用状态<br>- 3：未知状态
scene_type | int | 应用类型<br>**可选值有**：<br>- 0：自建应用<br>- 1：应用商店应用<br>- 2：个人应用商店应用<br>- 3：未知应用类型
payment_type | int | 付费类型<br>**可选值有**：<br>- 0：免费<br>- 1：付费
create_source | string | 应用创建来源(目前仅Base应用返回)<br>**可选值有**：<br>- developer_console：开发者后台<br>- base：多维表格自动化流程创建的应用<br>- app_engine：飞书 aPaaS<br>- bot_builder：机器人助手<br>- aily：aily(智能伙伴搭建平台)<br>- unknown：未知来源
redirect_urls | string\[\] | 安全设置中的重定向 URL
online_version_id | string | 发布在线上的应用版本 ID，若没有则为空
unaudit_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：日文<br>- zh_hk：繁体中文(中国香港)<br>- zh_tw：繁体中文(中国台湾)<br>- id_id：印度尼西亚语<br>- ms_my：马来语<br>- de_de：德语<br>- es_es：西班牙语<br>- fr_fr：法语<br>- it_it：意大利语<br>- pt_br：葡萄牙语(巴西)<br>- vi_vn：越南语<br>- ru_ru：俄语<br>- th_th：泰语<br>- ko_kr：韩语
name | string | 应用国际化名称
description | string | 应用国际化描述（副标题）
help_use | string | 国际化帮助文档链接
primary_language | string | 应用主语言<br>**可选值有**：<br>- zh_cn：中文<br>- en_us：英文<br>- ja_jp：日文
common_categories | string\[\] | 应用分类的国际化描述
owner | application.owner | 应用的所有者信息
type | int | 应用所有者类型<br>**可选值有**：<br>- 0：飞书科技<br>- 1：飞书合作伙伴<br>- 2：企业内成员
owner_id | string | 应用所有者ID
name | string | 应用开发商名称(仅商店应用返回)
help_desk | string | 应用开发商服务台链接(仅商店应用返回)
email | string | 应用开发商的邮箱(仅商店应用返回)
phone | string | 应用开发商的手机号(仅商店应用返回)
customer_service_account | string | 客服账号，仅当商店应用配置了这种联系方式时才会返回
mobile_default_ability | string | 移动端默认能力<br>**可选值有**：<br>- gadget：小程序<br>- web_app：网页应用<br>- bot：机器人
pc_default_ability | string | PC端默认能力<br>**可选值有**：<br>- gadget：小程序<br>- web_app：网页应用<br>- bot：机器人
has_more | boolean | 是否还有更多项
page_token | string | 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token

### 响应体示例
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "app_id": "cli_9b445f5258795107",
                "creator_id": "ou_d317f090b7258ad0372aa53963cda70d",
                "status": 1,
                "scene_type": 0,
                "payment_type": 0,
                "create_source": "base",
                "redirect_urls": [
                    "https://www.example.com"
                ],
                "online_version_id": "oav_d317f090b7258ad0372aa53963cda70d",
                "unaudit_version_id": "oav_d317f090b7258ad0372aa53963cda70d",
                "app_name": "应用名称",
                "avatar_url": "https://sf1-ttcdn-tos.pstatp.com/img/avatar/d279000ca4d3f7f6aaff~72x72.jpg",
                "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"
                    }
                ],
                "primary_language": "zh_cn",
                "common_categories": [
                    "分析工具"
                ],
                "owner": {
                    "type": 0,
                    "owner_id": "ou_d317f090b7258ad0372aa53963cda70d",
                    "name": "test tenant",
                    "help_desk": "https://applink.feishu.cn/client/helpdesk/open?id=6940534140529803284",
                    "email": "test123@163.com",
                    "phone": "1234534234234",
                    "customer_service_account": "feishu@bytedance.com"
                },
                "mobile_default_ability": "gadget",
                "pc_default_ability": "gadget"
            }
        ],
        "has_more": true,
        "page_token": "new-xxxxxxxxxxx"
    }
}
```

### 错误码

HTTP状态码 | 错误码 | 描述 | 排查建议
---|---|---|---
400 | 210500 | page_token does not exist or has expired | 请检查 page_token 是否合法，page_token 过期时间为 2h，若超过 2h 请重新获取
400 | 210501 | invalid page_token | page_token 在应用间不互通，请检查该 page_token 是否由调用接口的应用获取到
400 | 210502 | page_size out of range, should be between 1 and 50 | 请检查 page_size 范围是否在 [1, 50] 范围内

