公开内容

列出公开组织

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

只返回已批准、公开且未解散的组织;已归档组织仍可读取,以 archived 标识只读状态。分页与搜索不会返回私有组织或成员关系。匿名调用,不接受 Cookie。

无需认证

查询参数

qstring可选

按组织名称、标语或 slug 搜索,最多 500 字符。

长度 ≥ 0 · 长度 ≤ 500

pageinteger可选

从 1 开始的页码。

≥ 1 · ≤ 1000000

pageSizeinteger可选

每页条数,最多 50。

≥ 1 · ≤ 50

返回值

成功

totalinteger必填

≥ 0

pageinteger必填

≥ 1 · ≤ 1000000

pageSizeinteger必填

≥ 1 · ≤ 50

itemsobject[]必填

条目数 ≤ 50

idstring必填

长度 ≥ 26 · 长度 ≤ 26

slugstring必填

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

namestring必填

长度 ≥ 1 · 长度 ≤ 100

summarystring必填

长度 ≥ 0 · 长度 ≤ 200

avatarstring可选

长度 ≥ 0 · 长度 ≤ 2048

statusstring必填
可选值"approved""archived"
versioninteger必填

≥ 1 · ≤ 9007199254740991

taglinestring必填

长度 ≥ 0 · 长度 ≤ 200

categorystring必填

长度 ≥ 0 · 长度 ≤ 100

memberCountinteger必填

≥ 0

followerCountinteger必填

≥ 0

createdAtstring必填

长度 ≥ 1 · 长度 ≤ 64

接口信息

接口: GET /v1/site/organizations
operationId: listOrganizations

只返回已批准、公开且未解散的组织;已归档组织仍可读取,以 archived 标识只读状态。分页与搜索不会返回私有组织或成员关系。匿名调用,不接受 Cookie。

参数:

  • query q:按组织名称、标语或 slug 搜索,最多 500 字符。
  • query page:从 1 开始的页码。
  • query pageSize:每页条数,最多 50。