
# 获取用户绑定APP的api列表
#### 功能介绍
获取用户绑定app的API列表。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=ShowApisBindToApp)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-modelarts/modelarts_03_0138.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
GET /v1/{project_id}/app-auth/apps/{app_id}/auth-apis
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                               |
|:---|:---|:---|:---|
| app_id     | 是    | String | APP编号。                                                                                           |
| project_id | 是    | String | 用户项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 |
   
表2Query参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                               |
|:---|:---|:---|:---|
| limit        | 否    | String | 分页展示时，一页展示多少项。默认为1000。                                                                                                           |
| offset       | 否    | String | 分页展示时，从第几页开始。默认为0。                                                                                                               |
| order        | 否    | String | 返回的APP列表排序方式，可选值包括asc、desc。默认为asc。                                                                                               |
| service_name | 否    | String | API所属服务名称，支持模糊查找。                                                                                                                |
| sort_by      | 否    | String | 返回的APP列表按何属性排序，可选值包括app_name、created_at、updated_at。默认为name。                                                                      |
| workspace_id | 否    | String | 工作空间ID。获取方法请参见[查询工作空间列表](https://support.huaweicloud.com/api-modelarts/ListWorkspace.html)。未创建工作空间时默认值为"0"，存在创建并使用的工作空间，以实际取值为准。 |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                  |
|:---|:---|:---|:---|
| Content-Type | 否    | String | 消息体的类型。设置为text/plain，返回临时预览链接。设置为application/octet-stream，返回临时下载链接。 |
| X-Auth-Token | 是    | String | 用户token。                                                            |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数          | 参数类型                                                                                                  | 描述         |
|:---|:---|:---|
| apis        | Array of [AuthTypeApiBasicInfo] objects | API认证信息列表。 |
| count       | Integer                                                                                               | 查询数据个数。    |
| total_count | Integer                                                                                               | 数据总量。      |
   
 表5AuthTypeApiBasicInfo 
| 参数               | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|
| api_id           | String  | API编号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| api_method       | String  | 请求方式包含GET、POST、PUT、DELETE、HEAD、PATCH、OPTIONS、ANY，固定返回ANY。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| api_name         | String  | API名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| api_remark       | String  | API描述。字符长度不超过255。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| auth_type        | String  | API的认证方式。枚举值如下： - NONE：无认证   - APP：APP认证   - IAM：IAM认证    |
| predict_url      | String  | 预测地址。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| service_id       | String  | 服务编号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| service_name     | String  | 服务名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| support_app_code | Boolean | 是否支持APP CODE。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   
**状态码：401**
表6响应Body参数 
| 参数         | 参数类型   | 描述                                                                                   |
|:---|:---|:---|
| error_code | String | **参数解释**：ModelArts错误码。 **取值范围**：不涉及。 |
| error_msg  | String | **参数解释**：具体错误信息。 **取值范围**：不涉及。       |
   
**状态码：403**
表7响应Body参数 
| 参数         | 参数类型   | 描述                                                                                   |
|:---|:---|:---|
| error_code | String | **参数解释**：ModelArts错误码。 **取值范围**：不涉及。 |
| error_msg  | String | **参数解释**：具体错误信息。 **取值范围**：不涉及。       |
   
**状态码：404**
表8响应Body参数 
| 参数         | 参数类型   | 描述                                                                                   |
|:---|:---|:---|
| error_code | String | **参数解释**：ModelArts错误码。 **取值范围**：不涉及。 |
| error_msg  | String | **参数解释**：具体错误信息。 **取值范围**：不涉及。       |
   
#### 请求示例
```
GET https://{endpoint}/v1/{project_id}/app-auth/apps/{app_id}/auth-apis
```
#### 响应示例
**状态码：200**
OK
```
{
  "apis" : [ {
    "api_id" : "7e0d272df0e94297b7d4046bada3f158",
    "api_name" : "infer_ae20fc9fb37c48c28ebc3f3a638c9f48",
    "api_method" : "ANY",
    "predict_url" : "https://b86b2d069324491fbd66940e4533b45c.apig.xxxxxx.com/v1/infers/ae20fc9f-b37c-48c2-8ebc-3f3a638c9f48",
    "support_app_code" : true,
    "service_id" : "ae20fc9f-b37c-48c2-8ebc-3f3a638c9f48",
    "service_name" : "service-3c02"
  } ],
  "count" : 1
}
```
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 200 | OK           |
| 401 | Unauthorized |
| 403 | Forbidden    |
| 404 | Not Found    |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。
