个人 API

创建组织

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

账号须具备发布资格。创建后组织为 approved,创建者成为活跃所有者;slug 留空时由名称生成。需要 organization:create。

Bearer 令牌(organization:create)

请求体 必填

application/json

name 为必填;其他组织资料字段可选。

namestring必填

长度 ≥ 1 · 长度 ≤ 100

slugstring可选

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

summarystring可选

长度 ≥ 0 · 长度 ≤ 200

taglinestring可选

长度 ≥ 0 · 长度 ≤ 200

descriptionstring可选

长度 ≥ 0 · 长度 ≤ 10000

categorystring可选

长度 ≥ 0 · 长度 ≤ 100

joinPolicystring可选
可选值"open""apply"
visibilitystring可选
可选值"public""private"
avatarstring可选

长度 ≥ 0 · 长度 ≤ 2048

bannerstring可选

长度 ≥ 0 · 长度 ≤ 2048

返回值

成功

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"
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

接口信息

接口: POST /v1/personal/organizations
operationId: createOrganization

所需权限: organization:create

账号须具备发布资格。创建后组织为 approved,创建者成为活跃所有者;slug 留空时由名称生成。需要 organization:create。

参数:

  • body name
  • body slug
  • body summary
  • body tagline
  • body description
  • body category
  • body joinPolicy
  • body visibility
  • body avatar
  • body banner

请求体:name 为必填;其他组织资料字段可选。