组织令牌管理

组织令牌用于访问组织的 API，支持创建、查询、更新和删除操作。

获取令牌列表

获取当前组织的所有访问令牌。

请求

GET /api/v2/organization/tokens/

权限要求

只有组织的创建者才能管理令牌。

响应

[
    {
        "id": "token_id",
        "name": "令牌名称",
        "token": "access_token",
        "is_active": true,
        "expires_at": "2024-12-31T23:59:59Z",
        "created_at": "2024-01-08T10:00:00Z",
        "last_used_at": "2024-01-08T10:00:00Z"
    }
]

创建令牌

创建新的组织访问令牌。

请求

POST /api/v2/organization/tokens/

请求参数

字段	类型	必填	说明
name	string	是	令牌名称
expires_at	string	否	过期时间（ISO 8601 格式）

请求示例

{
    "name": "API访问令牌",
    "expires_at": "2024-12-31T23:59:59Z"
}

响应

返回创建的令牌信息，格式同列表项。

更新令牌

更新现有令牌的信息。

请求

PUT /api/v2/organization/tokens/{token_id}/

请求参数

字段	类型	必填	说明
name	string	否	令牌名称
is_active	boolean	否	是否启用
expires_at	string	否	过期时间

请求示例

{
    "name": "新令牌名称",
    "is_active": false
}

响应

返回更新后的令牌信息，格式同列表项。

删除令牌

删除指定的访问令牌。

请求

DELETE /api/v2/organization/tokens/{token_id}/

响应

成功删除返回 204 状态码，无响应内容。

错误码

错误码	说明
401	未认证
403	无权限（非创建者）
404	令牌不存在
400	请求参数错误