- 快速开始
- 身份源(Connection)
- 应用(Client)
- 资源服务器(ResourceServer)
- 用户(User)
- 角色(Role)
- 分组(Group)
- 租户(Tenant)
- 组织(Organization)
- 动作(Action)
- 授权(Grant)
- 应用授权(ClientGrant)
- 日志(Log)
- 自定义域名(CusomDomain)
- 密钥(Key)
- 任务(Job)
- 多因素认证(MFA)
- 安全防护(AttackProtection)
- 品牌化(Branding)
获取角色的用户列表
GET
/api/v1/roles/{id}/users
角色RBAC用户
请求参数
Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token示例:
Authorization: Bearer ********************
Path 参数
id
string
角色ID
示例值:
role_3ijjifojoiefj3
Query 参数
page
integer
页码
示例值:
1
page_size
integer
可选
示例值:
10
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://..authok.cn/api/v1/roles/role_3ijjifojoiefj3/users'
返回响应
🟢200成功
application/json
Body
meta
object (PageMeta)
必需
page
integer
页码
page_size
integer
每页显示数量
total
integer
记录总数
items
array[object (User) {34}]
必需
user_id
string
必需
connection
string
身份源
name
string
姓名
email
string
邮箱
email_verified
boolean
邮箱是否验证
phone_number
string
手机号
phone_country_code
string
手机国家代码
phone_number_verified
boolean
手机号是否验证
logins_count
integer
登录累积次数
blocked
boolean
必需
identities
array[object (Identity) {6}]
绑定的身份信息列表
user_metadata
object
可选
app_metadata
object
可选
signup_at
string
注册时间
updated_at
string
最后更新时间
created_at
string
用户创建时间
username
string
可选
nickname
string
昵称
given_name
string
名
family_name
string
姓
picture
string | null
头像地址
verify_email
boolean
邮箱是否已经过验证
gender
integer
可选
birthdate
string
生日
locale
string
区域
country
string
所在国家
city
string
城市
province
string
省份
region
string
南山区
address
string
详细地址
postal_code
string
邮政编码
signup_ip
string
注册IP
last_login
string
最后登录时间
last_ip
string
最后登录IP
示例
{
"meta": {
"page": 1,
"page_size": 20,
"total": 100
},
"items": [
{
"user_id": "authok|32jjf9uwfjew0ejfjffeio",
"connection": "authok",
"logins_count": 1002,
"blocked": false,
"identities": [
{
"connection": "wechat",
"user_id": "21",
"provider": "55",
"is_social": false,
"access_token": "cupidatat",
"profile_data": {
"email": "l.egthkri@qq.com",
"emailVerified": true,
"name": "置强就容",
"username": "陆娜",
"given_name": "金程合",
"phone_number": "89",
"phone_number_verified": false,
"family_name": "听例容二号",
"picture": "http://dummyimage.com/400x400",
"city": "温州市",
"province": "香港特别行政区",
"country": "incididunt do",
"gender": 7,
"nickname": "唐丽",
"openid": "82",
"unionid": "47"
}
},
{
"connection": "wechat",
"user_id": "42",
"provider": "7",
"is_social": true,
"access_token": "officia",
"profile_data": {
"email": "q.ushuj@qq.com",
"emailVerified": true,
"name": "山去受成",
"username": "任秀英",
"given_name": "往党片",
"phone_number": "67",
"phone_number_verified": true,
"family_name": "维记意解",
"picture": "http://dummyimage.com/400x400",
"city": "四平市",
"province": "辽宁省",
"country": "dolor irure pariatur occaecat",
"gender": 15,
"nickname": "曾桂英",
"openid": "1",
"unionid": "37"
}
},
{
"connection": "wechat",
"user_id": "31",
"provider": "65",
"is_social": false,
"access_token": "anim ut Lorem laborum",
"profile_data": {
"email": "d.qtvs@qq.com",
"emailVerified": true,
"name": "于院种组",
"username": "金芳",
"given_name": "论办少清象给",
"phone_number": "75",
"phone_number_verified": false,
"family_name": "技金应参先中",
"picture": "http://dummyimage.com/400x400",
"city": "上海市",
"province": "湖南省",
"country": "veniam",
"gender": 85,
"nickname": "龚杰",
"openid": "64",
"unionid": "19"
}
},
{
"connection": "wechat",
"user_id": "70",
"provider": "22",
"is_social": false,
"access_token": "id aute nulla anim deserunt",
"profile_data": {
"email": "v.iffuxknnn@qq.com",
"emailVerified": false,
"name": "下政备千",
"username": "白霞",
"given_name": "心全美党形",
"phone_number": "68",
"phone_number_verified": true,
"family_name": "布段最",
"picture": "http://dummyimage.com/400x400",
"city": "香港岛",
"province": "吉林省",
"country": "minim culpa",
"gender": 47,
"nickname": "董超",
"openid": "5",
"unionid": "39"
}
}
],
"signup_at": "2022-03-12 22:33:44",
"updated_at": "2022-03-12 23:33:44",
"signup_ip": "22.33.21.52",
"last_login": "2022-03-13 18:22:12",
"last_ip": "22.33.21.53",
"created_at": "2022-03-11 23:33:44",
"name": "李雷",
"gender": 1,
"city": "深圳",
"address": "粤海街道办A座A03室",
"verify_email": true,
"given_name": "雷",
"family_name": "李",
"country": "中国",
"phone_country_code": "86",
"email": "fioman@qq.com",
"postal_code": "518000",
"nickname": "fioman",
"username": "fioman",
"locale": "zh",
"phone_number": "18600002222",
"region": "区域",
"province": "广东",
"email_verified": true,
"birthdate": "1987-04-23",
"picture": "https://img.gavatars.com/a.png",
"phone_number_verified": true
}
]
}
修改于 2022-03-16 00:50:45