个人 API

读取本人可见的组织

GET /v1/personal/organizations/{slug}
GET/v1/personal/organizations/{slug}
下载规范

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

Bearer 令牌(organization:read:self)

路径参数

slugstring必填

组织的稳定标识。

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

返回值

成功

organizationobject必填

方案 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/{slug}
operationId: personalGetOrganization

所需权限: organization:read:self

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

参数:

  • path slug(必填):组织的稳定标识。