文档首页> AI开发平台ModelArts> API参考> APP认证管理> 授权API至APP
更新时间：2024-05-30 GMT+08:00
查看PDF

授权API至APP

功能介绍

将指定的API授权给APP。API的认证方式必须为APP认证，APP的创建用户必须是API所属服务的创建者，且请求用户对API所属服务必须有更新权限。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v1/{project_id}/services/{service_id}/app-auth-apis/{api_id}/app-auth-api

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

用户项目ID。获取方法请参见获取项目ID和名称。

service_id

是

String

API所属的服务ID。

api_id

是

String

API编号。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户token。
表3 请求Body参数

参数

是否必选

参数类型

描述

apps

是

Array of Apps objects

app列表。

workspace_id

否

String

工作空间id。
表4 Apps

参数

是否必选

参数类型

描述

app_id

否

String

APP的编号，可通过查询APP列表获取。

响应参数

状态码： 200

表5 响应Header参数

参数

参数类型

描述

X-Request-Id

String

链路追踪编号
表6 响应Body参数

参数

参数类型

描述

auth_result

Array of AppAuthResultInfo objects

授权结果列表。
表7 AppAuthResultInfo

参数

参数类型

描述

api_id

String

API的编号。

app_id

String

APP的编号，可通过查询APP列表获取。

auth_id

String

授权编号，授权失败时为空。

reason

String

授权或者取消授权失败原因，授权成功时为空。

success

Boolean

授权或者取消授权是否成功。

状态码： 401

表8 响应Header参数

参数

参数类型

描述

X-Request-Id

String

链路追踪编号
表9 响应Body参数

参数

参数类型

描述

error_code

String

ModelArts错误码。

error_msg

String

具体错误信息。

状态码： 403

表10 响应Header参数

参数

参数类型

描述

X-Request-Id

String

链路追踪编号
表11 响应Body参数

参数

参数类型

描述

error_code

String

ModelArts错误码。

error_msg

String

具体错误信息。

状态码： 404

表12 响应Header参数

参数

参数类型

描述

X-Request-Id

String

链路追踪编号
表13 响应Body参数

参数

参数类型

描述

error_code

String

ModelArts错误码。

error_msg

String

具体错误信息。

状态码： 500

表14 响应Header参数

参数

参数类型

描述

X-Request-Id

String

链路追踪编号
表15 响应Body参数

参数

参数类型

描述

error_code

String

ModelArts错误码。

error_msg

String

具体错误信息。

请求示例

授权应用给指定的api

POST https://{endpoint}/v1/{project_id}/services/{service_id}/app-auth-apis/{api_id}/app-auth-api

{
  "apps" : [ {
    "app_id" : "e2fb64be3be9418bb0f570c60f0ed93f"
  } ]
}

响应示例

状态码： 200

OK

{
  "auth_result" : [ {
    "api_id" : "logic-api-fe84e858-49ec-41c6-80d7-a34fc22435c2",
    "app_id" : "logic-app-ce0d0a41-451d-4563-94d9-acc75b5e440f",
    "success" : true
  } ]
}

状态码

状态码

描述

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

500

Server Internal Error

错误码

请参见错误码。

父主题： APP认证管理