小追加
Browse files- TOKEN_API.md +0 -172
- config.json +2 -1
TOKEN_API.md
DELETED
|
@@ -1,172 +0,0 @@
|
|
| 1 |
-
# Token 管理 API 文档
|
| 2 |
-
|
| 3 |
-
## 概述
|
| 4 |
-
|
| 5 |
-
提供对本地 Token 凭证的完整管理功能,支持增删改查和热重载。所有操作都会自动更新内存中的 Token 池。
|
| 6 |
-
|
| 7 |
-
## 认证
|
| 8 |
-
|
| 9 |
-
所有 API 请求需要在请求头中包含 API Key:
|
| 10 |
-
|
| 11 |
-
```
|
| 12 |
-
Authorization: Bearer sk-text // 配置内文件配置
|
| 13 |
-
```
|
| 14 |
-
|
| 15 |
-
## 接口列表
|
| 16 |
-
|
| 17 |
-
### 1. 获取 Token 列表
|
| 18 |
-
|
| 19 |
-
**请求**
|
| 20 |
-
```bash
|
| 21 |
-
GET /v1/tokens
|
| 22 |
-
```
|
| 23 |
-
|
| 24 |
-
**响应**
|
| 25 |
-
```json
|
| 26 |
-
{
|
| 27 |
-
"success": true,
|
| 28 |
-
"data": [
|
| 29 |
-
{
|
| 30 |
-
"refresh_token": "1//xxx",
|
| 31 |
-
"access_token_suffix": "...abc12345",
|
| 32 |
-
"expires_in": 3599,
|
| 33 |
-
"timestamp": 1234567890000,
|
| 34 |
-
"enable": true,
|
| 35 |
-
"projectId": "project-123"
|
| 36 |
-
}
|
| 37 |
-
]
|
| 38 |
-
}
|
| 39 |
-
```
|
| 40 |
-
|
| 41 |
-
### 2. 添加新 Token
|
| 42 |
-
|
| 43 |
-
**请求**
|
| 44 |
-
```bash
|
| 45 |
-
POST /v1/tokens
|
| 46 |
-
Content-Type: application/json
|
| 47 |
-
|
| 48 |
-
{
|
| 49 |
-
"access_token": "ya29.xxx",
|
| 50 |
-
"refresh_token": "1//xxx",
|
| 51 |
-
"expires_in": 3599
|
| 52 |
-
}
|
| 53 |
-
```
|
| 54 |
-
|
| 55 |
-
**响应**
|
| 56 |
-
```json
|
| 57 |
-
{
|
| 58 |
-
"success": true,
|
| 59 |
-
"message": "Token添加成功"
|
| 60 |
-
}
|
| 61 |
-
```
|
| 62 |
-
|
| 63 |
-
### 3. 更新 Token
|
| 64 |
-
|
| 65 |
-
**请求**
|
| 66 |
-
```bash
|
| 67 |
-
PUT /v1/tokens/{refresh_token}
|
| 68 |
-
Content-Type: application/json
|
| 69 |
-
|
| 70 |
-
{
|
| 71 |
-
"enable": false,
|
| 72 |
-
"access_token": "new_token"
|
| 73 |
-
}
|
| 74 |
-
```
|
| 75 |
-
|
| 76 |
-
**响应**
|
| 77 |
-
```json
|
| 78 |
-
{
|
| 79 |
-
"success": true,
|
| 80 |
-
"message": "Token更新成功"
|
| 81 |
-
}
|
| 82 |
-
```
|
| 83 |
-
|
| 84 |
-
### 4. 删除 Token
|
| 85 |
-
|
| 86 |
-
**请求**
|
| 87 |
-
```bash
|
| 88 |
-
DELETE /v1/tokens/{refresh_token}
|
| 89 |
-
```
|
| 90 |
-
|
| 91 |
-
**响应**
|
| 92 |
-
```json
|
| 93 |
-
{
|
| 94 |
-
"success": true,
|
| 95 |
-
"message": "Token删除成功"
|
| 96 |
-
}
|
| 97 |
-
```
|
| 98 |
-
|
| 99 |
-
### 5. 热重载 Token
|
| 100 |
-
|
| 101 |
-
**请求**
|
| 102 |
-
```bash
|
| 103 |
-
POST /v1/tokens/reload
|
| 104 |
-
```
|
| 105 |
-
|
| 106 |
-
**响应**
|
| 107 |
-
```json
|
| 108 |
-
{
|
| 109 |
-
"success": true,
|
| 110 |
-
"message": "Token已热重载"
|
| 111 |
-
}
|
| 112 |
-
```
|
| 113 |
-
|
| 114 |
-
## 使用示例
|
| 115 |
-
|
| 116 |
-
### 查看当前 Token 状态
|
| 117 |
-
```bash
|
| 118 |
-
curl http://localhost:8045/v1/tokens \
|
| 119 |
-
-H "Authorization: Bearer sk-text"
|
| 120 |
-
```
|
| 121 |
-
|
| 122 |
-
### 添加新账号
|
| 123 |
-
```bash
|
| 124 |
-
curl -X POST http://localhost:8045/v1/tokens \
|
| 125 |
-
-H "Authorization: Bearer sk-text" \
|
| 126 |
-
-H "Content-Type: application/json" \
|
| 127 |
-
-d '{
|
| 128 |
-
"access_token": "ya29.a0ARrdaM...",
|
| 129 |
-
"refresh_token": "1//0GWI4...",
|
| 130 |
-
"expires_in": 3599
|
| 131 |
-
}'
|
| 132 |
-
```
|
| 133 |
-
|
| 134 |
-
### 禁用某个账号
|
| 135 |
-
```bash
|
| 136 |
-
curl -X PUT http://localhost:8045/v1/tokens/1//0GWI4... \
|
| 137 |
-
-H "Authorization: Bearer sk-text" \
|
| 138 |
-
-H "Content-Type: application/json" \
|
| 139 |
-
-d '{"enable": false}'
|
| 140 |
-
```
|
| 141 |
-
|
| 142 |
-
### 删除账号
|
| 143 |
-
```bash
|
| 144 |
-
curl -X DELETE http://localhost:8045/v1/tokens/1//0GWI4... \
|
| 145 |
-
-H "Authorization: Bearer sk-text"
|
| 146 |
-
```
|
| 147 |
-
|
| 148 |
-
### 重新加载配置
|
| 149 |
-
```bash
|
| 150 |
-
curl -X POST http://localhost:8045/v1/tokens/reload \
|
| 151 |
-
-H "Authorization: Bearer sk-text"
|
| 152 |
-
```
|
| 153 |
-
|
| 154 |
-
## 注意事项
|
| 155 |
-
|
| 156 |
-
1. **refresh_token** 作为唯一标识符,不可重复
|
| 157 |
-
2. 所有操作会立即生效,无需重启服务
|
| 158 |
-
3. 删除操作不可恢复,请谨慎使用
|
| 159 |
-
4. Token 过期会自动刷新,无需手动维护
|
| 160 |
-
5. 禁用的 Token 不会参与轮换,但仍保存在文件中
|
| 161 |
-
|
| 162 |
-
## 错误码
|
| 163 |
-
|
| 164 |
-
- `400` - 请求参数错误
|
| 165 |
-
- `401` - API Key 验证失败
|
| 166 |
-
- `500` - 服务器内部错误
|
| 167 |
-
|
| 168 |
-
## 安全建议
|
| 169 |
-
|
| 170 |
-
- 定期备份 `data/accounts.json` 文件
|
| 171 |
-
- 不要在日志中暴露完整的 Token 信息
|
| 172 |
-
- 建议使用 HTTPS 部署生产环境
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
config.json
CHANGED
|
@@ -19,6 +19,7 @@
|
|
| 19 |
},
|
| 20 |
"other": {
|
| 21 |
"timeout": 180000,
|
| 22 |
-
"skipProjectIdFetch": false
|
|
|
|
| 23 |
}
|
| 24 |
}
|
|
|
|
| 19 |
},
|
| 20 |
"other": {
|
| 21 |
"timeout": 180000,
|
| 22 |
+
"skipProjectIdFetch": false,
|
| 23 |
+
"useNativeAxios": false
|
| 24 |
}
|
| 25 |
}
|