Appearance
组织管理
获取当前组织信息
获取当前用户所属组织的详细信息。
请求
http
GET /api/v2/organization/认证方式
支持两种认证方式:
- 用户登录认证
- 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/权限要求
只有组织的创建者才能更新组织信息。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 否 | 组织名称 |
| description | string | 否 | 组织描述 |
请求示例
json
{
"name": "新组织名称",
"description": "新的组织描述"
}响应
返回更新后的组织信息,格式同"获取当前组织信息"。
错误码
| 错误码 | 说明 |
|---|---|
| 401 | 未认证 |
| 403 | 无权限(非创建者) |
| 400 | 请求参数错误 |
组织令牌管理
组织令牌相关的 API 请参考 组织令牌管理。
