# 查询APP列表
#### 功能介绍
查询APP列表。
#### URI
HTTP/HTTPS请求方法以及URI如下表所示。
表1HTTP/HTTPS请求方法以及URI 
| 请求方法 | URI                                                                 |
|:---|:---|
| GET  | /v1.0/apigw/apps\[?page_size, page_no, id, name, app_key, creator\] |
   
![](https://support.huaweicloud.com/api-apig/public_sys-resources/note_3.0-zh-cn.png)
- 可以在URI后面用'?'和'\&'添加不同的查询条件组合。
- 查询条件可为以下字段以及对应的值：id、name、app_key、creator、page_size、page_no。
 
URI中的参数说明如下表所示。
表2参数说明 
| 名称             | 是否必选 | 类型      | 说明                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| id             | 否    | String  | 编号                                                                                                                                                                                                                                                                                                                                                                                                                 |
| name           | 否    | String  | 名称                                                                                                                                                                                                                                                                                                                                                                                                                 |
| status         | 否    | Integer | 状态                                                                                                                                                                                                                                                                                                                                                                                                                 |
| app_key        | 否    | String  | APP的KEY                                                                                                                                                                                                                                                                                                                                                                                                            |
| creator        | 否    | String  | APP的创建者，取值如下： - USER：用户自行创建  - MARKET：云商店分配   |
| page_size      | 否    | Integer | 每页显示的条数，默认值：20                                                                                                                                                                                                                                                                                                                                                                                                     |
| page_no        | 否    | Integer | 页码，默认值：1                                                                                                                                                                                                                                                                                                                                                                                                           |
| precise_search | 否    | String  | 指定需要精确匹配查找的参数名称，目前仅支持name                                                                                                                                                                                                                                                                                                                                                                                          |
   
#### 请求消息
无
#### 响应消息
表3参数说明 
| 名称    | 类型      | 说明          |
|:---|:---|:---|
| total | Integer | 符合条件的APP总数  |
| size  | Integer | 本次查询返回的列表长度 |
| apps  | 字典数据类型  | APP列表       |
   
表4apps参数说明 
| 参数            | 类型        | 说明                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|
| id            | String    | 编号                                                                                                                                                                                                                                                                                                                                                                                                                              |
| name          | String    | 名称                                                                                                                                                                                                                                                                                                                                                                                                                              |
| status        | Integer   | 状态                                                                                                                                                                                                                                                                                                                                                                                                                              |
| app_key       | String    | APP的key                                                                                                                                                                                                                                                                                                                                                                                                                         |
| app_secret    | String    | 密钥                                                                                                                                                                                                                                                                                                                                                                                                                              |
| register_time | Timestamp | 创建时间                                                                                                                                                                                                                                                                                                                                                                                                                            |
| remark        | String    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                              |
| update_time   | Timestamp | 更新时间                                                                                                                                                                                                                                                                                                                                                                                                                            |
| creator       | String    | APP的创建者，取值如下： - USER：用户自行创建  - MARKET：云商店分配   |
| app_type      | String    | APP类型，默认为apig                                                                                                                                                                                                                                                                                                                                                                                                                   |
| bind_num      | Integer   | 绑定的API数量                                                                                                                                                                                                                                                                                                                                                                                                                        |
   
响应消息样例：
```
{
"total": 2,
"size": 2,
"apps": [{
"id": "98ef****a286a4",
"name": "app_002",
"status": 1,
"app_key": "f627f****54d3fe2",
"app_secret": "******",
"remark": "第二个APP",
"register_time": "2017-12-28T12:32:50Z",
"update_time": "2017-12-28T12:32:50Z",
"creator": "MARKET",
                "app_type": "apig",
                "bind_num": 2
},
{
"id": "14b39****4537e9",
"name": "app_001",
"status": 1,
"app_key": "d49b****76eb",
"app_secret": "******",
"remark": "第一个APP",
"register_time": "2017-12-28T12:26:54Z",
"update_time": "2017-12-28T12:29:35.571Z",
"creator": "USER",
                "app_type": "apig",
                "bind_num": 2
}]
}
```
#### 状态码
表5返回消息说明 
| 状态码 | 说明                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 500 | Server Internal Error |