创建机构

POST/web/v1/workspaces/{workspaceId}/institutionsWEB

在指定工作空间下创建新机构。

鉴权

需要有效的 JWT token。网关验证：enableJwtToken=true，enableTurnstile=false。

请求参数

路径参数

Name	Type	Required	In	Description
workspaceId	string	Yes	path	工作空间业务 ID

请求体

UserInstitutionCreateRequest:

Name	Type	Required	In	Description
institutionName	string	Yes	body	机构名称（最多 126 个字符）
institutionDescription	string	No	body	机构描述（最多 255 个字符）
institutionRemark	string	No	body	机构备注（最多 255 个字符）
institutionType	string	Yes	body	机构类型枚举：SYSTEM、TENANT、PARTNER、CONSUMER
extraConfig	object	No	body	额外配置，包含官方资料和社交媒体信息
extraConfig.official	object	No	body	官方商业资料（名称、网站、邮箱、电话、地址、描述）
extraConfig.social	object	No	body	社交媒体联系方式（telegram、whatsApp、discord、twitter）

成功响应

成功200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "bizId": "inst_abc123",
    "institutionName": "Acme Corp",
    "institutionDescription": "Main institution",
    "institutionRemark": null,
    "institutionType": "TENANT",
    "institutionStatus": "ACTIVE",
    "extraConfig": null,
    "createdAt": "2026-03-21T00:00:00Z",
    "updatedAt": "2026-03-21T00:00:00Z"
  }
}

错误响应

错误码	描述
4000	验证错误（缺少必填字段、无效的机构类型）
4010	未授权（无效或缺少 JWT token）

说明

• bizId 由系统自动生成。
• institutionStatus 在创建时设置为初始状态。
• createdBy 和 updatedBy 从安全上下文中填充。