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 请参考 组织令牌管理。