Skip to content

组织管理

获取当前组织信息

获取当前用户所属组织的详细信息。

请求

http
GET /api/v2/organization/

认证方式

支持两种认证方式:

  1. 用户登录认证
  2. Token 认证(在请求头中添加 Authorization: Bearer <token>

权限要求

需要有效的组织访问权限。

响应

json
{
    "id": "org_id",
    "name": "组织名称",
    "description": "组织描述",
    "created_at": "2024-01-08T10:00:00Z",
    "updated_at": "2024-01-08T10:00:00Z",
    "creator": {
        "id": "user_id",
        "username": "创建者用户名"
    }
}

更新组织信息

更新当前组织的信息。

请求

http
PUT /api/v2/organization/

权限要求

只有组织的创建者才能更新组织信息。

请求参数

字段类型必填说明
namestring组织名称
descriptionstring组织描述

请求示例

json
{
    "name": "新组织名称",
    "description": "新的组织描述"
}

响应

返回更新后的组织信息,格式同"获取当前组织信息"。

错误码

错误码说明
401未认证
403无权限(非创建者)
400请求参数错误

组织令牌管理

组织令牌相关的 API 请参考 组织令牌管理