# 查询已购买的API列表
#### 功能介绍
租户查询已购买的API列表。
#### URI
HTTP/HTTPS请求方法以及URI如下表所示。
表1HTTP/HTTPS请求方法以及URI 
| 请求方法 | URI                                                                                       |
|:---|:---|
| GET  | /v1.0/apigw/purchases/apis\[?page_size, page_no, api_id, api_name, group_id, group_name\] |
   
![](https://support.huaweicloud.com/api-apig/public_sys-resources/note_3.0-zh-cn.png)
- 可以在URI后面用'?'和'\&'添加不同的查询条件组合。
- 查询条件可为以下字段以及对应的值：api_id、api_name、group_id 、group_name 、page_size、page_no。
 
URI中的参数说明如下表所示。
表2参数说明 
| 名称         | 是否必选 | 类型      | 说明             |
|:---|:---|:---|:---|
| api_id     | 否    | String  | API编号          |
| api_name   | 否    | String  | API名称          |
| group_id   | 否    | String  | API分组编号        |
| group_name | 否    | String  | API分组名称        |
| page_size  | 否    | Integer | 每页显示的条数，默认值：20 |
| page_no    | 否    | Integer | 页码，默认值：1       |
   
#### 请求消息
无
#### 响应消息
表3参数说明 
| 名称    | 类型      | 说明           |
|:---|:---|:---|
| total | Integer | 满足查询条件的API总数 |
| size  | Integer | 本次查询返回的API个数 |
| apis  | 字典数据类型  | 本次查询返回的API列表 |
   
表4apis参数说明 
| 参数          | 类型     | 说明       |
|:---|:---|:---|
| id          | String | API编号    |
| name        | String | API名称    |
| purchase_id | String | 订购关系编号   |
| remark      | String | API描述    |
| req_uri     | String | API的访问地址 |
   
响应消息样例：
```
{
"total": 3,
"size": 3,
"apis": [{
"id": "cb498965-8acf-4c98-bd08-4033ef1fcfb4",
"name": "查询环境列表",
"purchase_id": "730f8a84-c8db-45ba-a6a5-2669ceb08574",
"remark": "查询环境列表",
"req_uri": "/envs"
},
{
"id": "5bbc47e2-95b0-4a56-904e-a3cdc422f8e9",
"name": "查询分组列表",
"purchase_id": "2ae11f50-3938-4560-8b76-58e89bb3f825",
"remark": "查询分组列表",
"req_uri": "/groups"
},
{
"id": "6632a062-9dcf-4f18-9646-3cabb925a290",
"name": "查询API列表",
"purchase_id": "2ae11f50-3938-4560-8b76-58e89bb3f825",
"remark": "查询API列表",
"req_uri": "/apis"
}]
}
```
#### 状态码
表5返回消息说明 
| 状态码 | 说明                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 500 | Server Internal Error |