个人 API

列出本人组织

GET /v1/personal/organizations
GET/v1/personal/organizations
下载规范

分页返回本人拥有或作为活跃成员加入的组织。已归档组织以 archived 标识只读状态;已解散组织仅返回最小墓碑。需要 organization:read:self。

Bearer 令牌(organization:read:self)

查询参数

pageinteger可选

从 1 开始的页码。

≥ 1 · ≤ 1000000

pageSizeinteger可选

每页条数,最多 50。

≥ 1 · ≤ 50

返回值

成功

totalinteger必填

≥ 0

pageinteger必填

≥ 1 · ≤ 1000000

pageSizeinteger必填

≥ 1 · ≤ 50

itemsobject[]必填

条目数 ≤ 50

[]object

方案 1 · object

idstring必填

长度 ≥ 26 · 长度 ≤ 26

slugstring必填

长度 ≥ 1 · 长度 ≤ 100 · 格式:^[a-z0-9][a-z0-9-]{0,99}$

namestring必填

长度 ≥ 1 · 长度 ≤ 100

summarystring必填

长度 ≥ 0 · 长度 ≤ 200

taglinestring必填

长度 ≥ 0 · 长度 ≤ 200

descriptionstring必填

长度 ≥ 0 · 长度 ≤ 10000

categorystring必填

长度 ≥ 0 · 长度 ≤ 100

avatarstring可选

长度 ≥ 0 · 长度 ≤ 2048

bannerstring可选

长度 ≥ 0 · 长度 ≤ 2048

ownerIdstring必填

长度 ≥ 26 · 长度 ≤ 26

rolestring必填
可选值"owner""admin""member"
statusstring必填
可选值"approved""suspended""pending""rejected""archived"
visibilitystring必填
可选值"public""private"
joinPolicystring必填
可选值"open""apply"
versioninteger必填

≥ 1 · ≤ 9007199254740991

createdAtstring必填

长度 ≥ 1 · 长度 ≤ 64

updatedAtstring必填

长度 ≥ 1 · 长度 ≤ 64

方案 2 · object

idstring必填

长度 ≥ 26 · 长度 ≤ 26

slugstring必填

长度 ≥ 1 · 长度 ≤ 100 · 格式:^[a-z0-9][a-z0-9-]{0,99}$

namestring必填

长度 ≥ 1 · 长度 ≤ 100

summarystring必填

长度 ≥ 0 · 长度 ≤ 200

avatarstring可选

长度 ≥ 0 · 长度 ≤ 2048

rolestring必填
可选值"owner""admin""member"
statusstring必填
可选值"dissolved"
versioninteger必填

≥ 1 · ≤ 9007199254740991

dissolvedAtstring必填

长度 ≥ 1 · 长度 ≤ 64

接口信息

接口: GET /v1/personal/organizations
operationId: personalListOrganizations

所需权限: organization:read:self

分页返回本人拥有或作为活跃成员加入的组织。已归档组织以 archived 标识只读状态;已解散组织仅返回最小墓碑。需要 organization:read:self。

参数:

  • query page:从 1 开始的页码。
  • query pageSize:每页条数,最多 50。