Query Application-Side Role Details

Permissions

The identity management API is authorized by application. Before calling the API, you need to set API permissions for different applications. For details, see API Permissions.

Permission Code	Description
app_role_read	Read permission for application-side role APIs
read	Read permission for all read APIs
all	Read/Write permission for all APIs

Request

Request Headers

Parameter Name	Name	Required	Type	Description
Authorization	Authorization	Yes	String	Format: Bearer {access_token}
Content-Type	Content Type	Yes	String	Fixed value: application/json; charset=utf-8

Request Example

None

Request Parameters

Parameter Name	Name	Required	Type	Description
app_id	Application ID	Yes	String	Target application ID
role_id	Application-side role ID	Yes	String	Target role ID

Response Example

Success Example

HTTP/1.1 200 OK

{
    "id": "20220420144449385-C66D-E8C1D1D79",
    "code": "admin",
    "name": "Administrator",
    "createdAt": "2022-04-20 14:44:49.385",
    "updatedAt": null
}

Error Example

HTTP/1.1 400 Bad Request

{
    "error_code": " APP.ROLE.0002",
    "error_msg": "The application-side role does not exist"
}

Response Parameters

Parameter Name	Name	Type	Description
id	Role ID	String
code	Role CODE	String
name	Role Name	String
createdAt	Creation Time	String
updatedAt	Update Time	String

Error Codes

Status Code	Error Code	Chinese Error Message	English Error Message	Resolution
400	APP.ROLE.0002	应用侧角色不存在	The application side role does not exist	Please check whether the application-side role has been deleted
400	APP.OBJECTMODEL.0006	未开启应用角色模型	The application role model is not opened	Please check whether the application role model is enabled
400	APP.0001	应用不存在	App does not exist	Please check whether the application has been deleted