ListUserResources - 查询用户有权限的资源

更新时间:
复制 MD 格式

通过 OpenAPI 查询用户有权限的资源,包括代码库和代码组。

适用版本

中心版、Region版

服务接入点与授权信息

产品

资源

所需权限

代码管理

用户资源

只读

请求语法

中心版

GET https://{domain}/oapi/v1/codeup/organizations/{organizationId}/users/vision/user_resources

Region版

GET https://{domain}/oapi/v1/codeup/users/vision/user_resources

请求头

参数

类型

是否必填

描述

示例值

x-yunxiao-token

string

是

个人访问令牌。

pt-0fh3****0fbG_35af****0484

请求参数

参数

类型

位置

是否必填

描述

示例值

organizationId

string

path

  • 是:中心版

  • 否:Region版

组织 ID。

60d54f3daccf2bbd6659f3ad

user_ids

string

query

否

用户 ID 列表,多个用逗号分隔。

62c795xxxb468af8,62c795xxxb468af9

page

integer

query

否

页码,默认从1开始。

1

per_page

integer

query

否

每页大小,默认10,最大20。

10

请求示例

中心版

curl -X 'GET' \
  'https://{domain}/oapi/v1/codeup/organizations/60d54f3daccf2bbd6659f3ad/users/vision/user_resources?user_ids=62c795xxxb468af8,62c795xxxb468af9&page=1&per_page=10' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484'

Region版

curl -X 'GET' \
  'https://{domain}/oapi/v1/codeup/users/vision/user_resources?user_ids=62c795xxxb468af8,62c795xxxb468af9&page=1&per_page=10' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484'

返回参数

参数

类型

描述

示例值

-

array

-

object

group_infos

array

用户所属的代码组列表。

-

object

group_info

object

avatar

string

头像地址。

https://example.com/avatar.png

created_at

string

创建时间。

2025-04-21T10:16:45+08:00

description

string

代码组描述。

代码组描述信息

id

integer

代码组 ID。

2813489

name

string

代码组名称。

demo-group

path

string

代码组路径。

demo-group

updated_at

string

更新时间。

2025-07-14T10:31:41+08:00

visibility_level

string

可见性:0-私有,10-内部公开。

0

role_info

object

access_level

integer

访问权限:20-浏览者,30-开发者,40-管理员。

30

cn_role_name

string

角色名称(中文)。

开发者

en_role_name

string

角色名称(英文)。

Developer

source_id

integer

资源 ID。

2813489

source_type

string

资源类型:PROJECT-代码库,NAMESPACE-代码组。

PROJECT

repository_infos

array

用户所属的代码库列表。

-

object

repository_info

object

avatarUrl

string

头像地址。

https://example.com/avatar.png

created_at

string

创建时间。

2025-06-25T10:27:09+08:00

description

string

代码库描述。

代码库描述信息

id

integer

代码库 ID。

2813489

last_activity_at

string

最后活跃时间。

2025-09-18T10:59:35+08:00

name

string

代码库名称。

demo-repo

nameWithNamespace

string

代码库完整名称(含完整组名称)。

demo-group / demo-repo

path

string

代码库路径。

demo-repo

updated_at

string

更新时间。

2025-09-18T10:59:35+08:00

visibility_level

string

可见性:0-私有,10-内部公开。

0

role_info

object

access_level

integer

访问权限:20-浏览者,30-开发者,40-管理员。

30

cn_role_name

string

角色名称(中文)。

开发者

en_role_name

string

角色名称(英文)。

Developer

source_id

integer

资源 ID。

2813489

source_type

string

资源类型:PROJECT-代码库,NAMESPACE-代码组。

PROJECT

user_info

object

avatar

string

头像地址。

https://example.com/avatar.png

email

string

邮箱。

zhangsan@example.com

id

integer

用户 ID。

2813489

name

string

用户名称。

张三

username

string

用户名。

zhangsan

返回示例

[
    {
        "group_infos": [
            {
                "group_info": {
                    "avatar": "https://example.com/avatar.png",
                    "created_at": "2025-04-21T10:16:45+08:00",
                    "description": "代码组描述信息",
                    "id": 2813489,
                    "name": "demo-group",
                    "path": "demo-group",
                    "updated_at": "2025-07-14T10:31:41+08:00",
                    "visibility_level": "0"
                },
                "role_info": {
                    "access_level": 30,
                    "cn_role_name": "开发者",
                    "en_role_name": "Developer",
                    "source_id": 2813489,
                    "source_type": "PROJECT"
                }
            }
        ],
        "repository_infos": [
            {
                "repository_info": {
                    "avatarUrl": "https://example.com/avatar.png",
                    "created_at": "2025-06-25T10:27:09+08:00",
                    "description": "代码库描述信息",
                    "id": 2813489,
                    "last_activity_at": "2025-09-18T10:59:35+08:00",
                    "name": "demo-repo",
                    "nameWithNamespace": "demo-group / demo-repo",
                    "path": "demo-repo",
                    "updated_at": "2025-09-18T10:59:35+08:00",
                    "visibility_level": "0"
                },
                "role_info": {
                    "access_level": 30,
                    "cn_role_name": "开发者",
                    "en_role_name": "Developer",
                    "source_id": 2813489,
                    "source_type": "PROJECT"
                }
            }
        ],
        "user_info": {
            "avatar": "https://example.com/avatar.png",
            "email": "zhangsan@example.com",
            "id": 2813489,
            "name": "张三",
            "username": "zhangsan"
        }
    }
]

响应头

参数

描述

示例值

x-next-page

下一页。

2

x-page

当前页。

1

x-per-page

每页大小。

10

x-prev-page

上一页。

0

x-total

总条数。

100

x-total-pages

总页数。

10

错误码

访问错误码中心查看 API 相关错误码。