- 开发集成
- /
- 标准 Web 应用
- /
- C#
- /
管理模块
- /
用户管理
- /
- 判断用户是否有某个角色
¶ 判断用户是否有某个角色
更新时间: 2024-10-10 07:28:40
通过用户 ID,判断用户是否有某个角色,支持传入多个角色,可以选择指定用户 ID 类型等。
¶ 请求参数
名称 | 类型 | 必填 | 默认值 | 描述 | 示例值 |
---|---|---|---|---|---|
roles | HasRoleRolesDto[] | 是 | - | 角色列表。 | |
userId | string | 是 | - | 用户 ID。 | 6229ffaxxxxxxxxcade3e3d9 |
options | HasAnyRoleOptionsDto | 否 | - | 可选参数。 |
¶ 示例代码
using Authing.CSharp.SDK.Models;
using Authing.CSharp.SDK.Services;
using Authing.CSharp.SDK.Utils;
using Authing.CSharp.SDK.UtilsImpl;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
namespace Example
{
class Program
{
private static ManagementClientOptions options;
private static string ACCESS_Key_ID = "AUTHING_USERPOOL_ID";
private static string ACCESS_KEY_SECRET = "AUTHING_USERPOOL_SECRET";
static void Main(string[] args)
{
MainAsync().GetAwaiter().GetResult();
}
private static async Task MainAsync()
{
options = new ManagementClientOptions()
{
AccessKeyId = ACCESS_Key_ID,
AccessKeySecret = ACCESS_KEY_SECRET,
};
ManagementClient managementClient = new ManagementClient(options);
HasAnyRoleRespDto result = await managementClient.HasAnyRole
( new HasAnyRoleReqDto{ UserId= "6229ffaxxxxxxxxcade3e3d9" ,
Roles= new List<HasRoleRolesDto>
{
new HasRoleRolesDto
{
Namespace= "default" ,
Code= "admin" ,
}
},
Options= new HasAnyRoleOptionsDto
{
UserIdType= HasAnyRoleOptionsDto.userIdType.USER_ID ,
},
}
);
}
}
}
¶ 请求响应
类型: HasAnyRoleRespDto
名称 | 类型 | 描述 |
---|---|---|
statusCode | number | 业务状态码,可以通过此状态码判断操作是否成功,200 表示成功。 |
message | string | 描述信息 |
apiCode | number | 细分错误码,可通过此错误码得到具体的错误类型。 |
data | HasAnyRoleDto | 响应数据 |
示例结果:
{
"statusCode": 200,
"message": "操作成功",
"apiCode": 20001,
"data": {
"hasAnyRole": true
}
}
¶ 数据结构
¶ HasRoleRolesDto
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
namespace | string | 否 | 所属权限分组的 code。 示例值: default |
code | string | 是 | 角色 code。 示例值: admin |
¶ HasAnyRoleOptionsDto
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userIdType | string | 否 | 用户 ID 类型,可以指定为用户 ID、手机号、邮箱、用户名和 externalId。。 枚举值:user_id ,external_id ,phone ,email ,username |
¶ HasAnyRoleDto
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
hasAnyRole | boolean | 是 | 是否拥有其中某一个角色。 示例值: true |