WebToolkit 后台管理系统

螺丝管理

🔧

欢迎使用 WebToolkit 后台管理系统

请从左侧导航栏选择功能模块开始操作

🔩

螺丝管理

查询/新增/导入

📖

API 文档

接口使用说明

📋

操作日志

查看系统记录

新增螺栓

ID	型号	分类	直径	长度	螺距	头型	材质	标准	操作

每页显示条

批量导入

支持 JSON 格式批量导入。每行数据必须包含 model、category、diameter 三个必填字段。

API Token 管理

API Token 用于通过 API 接口操作数据

用户管理

只有管理员可以添加、修改、删除用户

ID	用户名	角色	创建时间	操作

操作日志

记录所有用户操作、API 调用和系统变更

时间	用户	操作	方式	路径	详情	结果

API 模块

🔩 螺丝管理

👥 用户管理

🔑 Token 管理

📋 操作日志

🔐 认证登录

🔩 螺丝管理 API 文档

Base URL: https://bolt-tools.pages.dev

认证方式

读操作（GET）无需认证。写操作（POST/PUT/DELETE）需要 API Token。

X-Api-Key: your-api-token-here

公开端点

GET /api/bolts

查询螺栓列表，支持搜索、分类筛选、分页。通常先用此接口搜索获取 ID，再用 /api/bolts/:id 查详情。

参数	类型	必填	说明
`search`	string	否	搜索关键词，模糊匹配型号/描述/直径/标准
`category`	string	否	按分类精确筛选（如 Hex Bolt）
`page`	integer	否	页码，默认 1
`limit`	integer	否	每页数量，默认 20，最大 100

使用示例

# 查询全部（第1页，每页20条）
GET /api/bolts

# 搜索包含 M10 的螺栓
GET /api/bolts?search=M10

# 只看六角螺栓分类，每页50条
GET /api/bolts?category=Hex Bolt&limit=50

# 第3页，每页10条
GET /api/bolts?page=3&limit=10

响应示例

{
  "data": [
    {
      "id": 1,
      "model": "M10x50",
      "category": "Hex Bolt",
      "diameter": "M10",
      "length": "50mm",
      "thread_pitch": "1.5mm",
      "head_type": "Hex Head",
      "material": "Carbon Steel 8.8",
      "standard": "DIN 933",
      "description": "Standard hex bolt"
    }
  ],
  "total": 42,
  "page": 1,
  "limit": 20,
  "total_pages": 3
}

GET /api/bolts/:id

获取单个螺栓详情

请求示例

curl https://bolt-tools.pages.dev/api/bolts/1

响应示例

{
  "data": {
    "id": 1,
    "model": "M10x50",
    "category": "Hex Bolt",
    "diameter": "M10",
    "length": "50mm",
    "thread_pitch": "1.5mm",
    "head_type": "Hex Head",
    "material": "Carbon Steel 8.8",
    "standard": "DIN 933",
    "description": "Standard hex bolt M10x50"
  }
}

GET /api/categories

获取所有分类及螺栓数量统计

请求示例

curl https://bolt-tools.pages.dev/api/categories

响应示例

{
  "data": [
    { "category": "Hex Bolt", "count": 1986 },
    { "category": "Socket Head Cap Screw", "count": 306 },
    { "category": "Self-tapping Screw", "count": 468 },
    { "category": "Carriage Bolt", "count": 120 }
  ]
}

认证端点（需要 X-Api-Key）

POST /api/bolts

创建新螺栓记录（需要 X-Api-Key）

请求示例

curl -X POST https://bolt-tools.pages.dev/api/bolts   -H "Content-Type: application/json"   -H "X-Api-Key: your-api-token"   -d '{
    "model": "M16x80",
    "category": "Hex Bolt",
    "diameter": "M16",
    "length": "80mm",
    "thread_pitch": "2.0mm",
    "head_type": "Hex Head",
    "material": "Carbon Steel 10.9",
    "standard": "DIN 931",
    "description": "High-strength hex bolt"
  }'

响应示例

{
  "success": true,
  "id": 6208
}

字段	类型	必填	说明
`model`	string	是 *	型号
`category`	string	是 *	分类
`diameter`	string	是 *	直径
`length`	string	否	长度
`thread_pitch`	string	否	螺距
`head_type`	string	否	头型
`material`	string	否	材质
`standard`	string	否	标准
`description`	string	否	描述

PUT /api/bolts/:id

更新螺栓，只传需要修改的字段（需要 X-Api-Key）

请求示例（只修改描述和材质）

curl -X PUT https://bolt-tools.pages.dev/api/bolts/6208   -H "Content-Type: application/json"   -H "X-Api-Key: your-api-token"   -d '{
    "description": "Updated description",
    "material": "Stainless Steel 316"
  }'

响应示例

{ "success": true }

DELETE /api/bolts/:id

删除螺栓记录，不可撤销（需要 X-Api-Key）

请求示例

curl -X DELETE https://bolt-tools.pages.dev/api/bolts/6208 -H "X-Api-Key: your-api-token"

响应示例

{ "success": true }

响应格式

{
  "data": [...],
  "total": 100,
  "page": 1,
  "limit": 20,
  "total_pages": 5
}

错误码

状态码	含义
`200`	成功
`201`	创建成功
`400`	参数错误
`401`	未授权（缺少或无效 Token）
`404`	未找到

👥 用户管理 API 文档

所有用户管理接口均需管理员权限（admin role）

GET /admin/users

获取所有用户列表（仅管理员）

请求示例

curl https://bolt-tools.pages.dev/admin/users -H "Authorization: Bearer your-session-token"

响应示例

{
  "data": [
    { "id": 1, "username": "pipi", "role": "admin", "created_at": "2026-07-27 11:21:31" },
    { "id": 2, "username": "zhangsan", "role": "user", "created_at": "2026-07-28 09:15:00" }
  ]
}

POST /admin/users

创建新用户（仅管理员）

字段	类型	必填	说明
`username`	string	是 *	用户名（唯一）
`password`	string	是 *	密码
`role`	string	否	角色: admin / user（默认 user）

请求示例

curl -X POST https://bolt-tools.pages.dev/admin/users   -H "Content-Type: application/json"   -H "Authorization: Bearer your-session-token"   -d '{ "username": "zhangsan", "password": "Pass123!", "role": "user" }'

响应示例

{ "success": true, "id": 3 }

PUT /admin/users/:id

修改用户（密码/角色），只传需要修改的字段

字段	类型	说明
`password`	string	新密码（留空不修改）
`role`	string	新角色: admin / user

请求示例（修改角色为管理员）

curl -X PUT https://bolt-tools.pages.dev/admin/users/3   -H "Content-Type: application/json"   -H "Authorization: Bearer your-session-token"   -d '{ "role": "admin" }'

请求示例（只改密码）

curl -X PUT https://bolt-tools.pages.dev/admin/users/3   -H "Content-Type: application/json"   -H "Authorization: Bearer your-session-token"   -d '{ "password": "NewPass456!" }'

响应示例

{ "success": true }

DELETE /admin/users/:id

删除用户及其所有 Token（不可删除自己）

请求示例

curl -X DELETE https://bolt-tools.pages.dev/admin/users/3 -H "Authorization: Bearer your-session-token"

响应示例

{ "success": true }

🔑 Token 管理 API 文档

管理员可管理所有用户的 Token，普通用户只能管理自己的

GET /admin/tokens

获取 Token 列表（管理员看全部含 username，普通用户看自己的）

请求示例

curl https://bolt-tools.pages.dev/admin/tokens -H "Authorization: Bearer your-session-token"

响应示例（管理员视角）

{
  "data": [
    { "id": 1, "token": "fa6944c9...", "name": "Default", "created_at": "2026-07-27 12:47:15", "user_id": 1, "username": "pipi" },
    { "id": 2, "token": "b8bc1c30...", "name": "生产环境", "created_at": "2026-07-28 10:00:00", "user_id": 2, "username": "zhangsan" }
  ]
}

POST /admin/tokens

生成新 Token（管理员可通过 user_id 为任意用户生成）

字段	类型	必填	说明
`name`	string	否	Token 名称（默认 Default）
`user_id`	integer	否	目标用户 ID（仅管理员有效）

请求示例（为自己生成）

curl -X POST https://bolt-tools.pages.dev/admin/tokens   -H "Content-Type: application/json"   -H "Authorization: Bearer your-session-token"   -d '{ "name": "生产环境" }'

请求示例（管理员为用户2生成）

curl -X POST https://bolt-tools.pages.dev/admin/tokens   -H "Content-Type: application/json"   -H "Authorization: Bearer your-session-token"   -d '{ "name": "测试环境", "user_id": 2 }'

响应示例

{
  "token": "a1b2c3d4e5f6...",
  "name": "生产环境",
  "user_id": 1
}

DELETE /admin/tokens/:id

删除指定 Token（只能删除自己的）

请求示例

curl -X DELETE https://bolt-tools.pages.dev/admin/tokens/2 -H "Authorization: Bearer your-session-token"

响应示例

{ "success": true }

📋 操作日志 API 文档

仅管理员可访问，记录所有用户操作和 API 调用

GET /admin/audit-logs?action=xxx&user=xxx&page=1&limit=50

查询操作日志，支持按操作类型和用户名筛选

参数	类型	必填	说明
`action`	string	否	操作类型: login, bolt_create, bolt_delete, bolt_bulk_import, user_create, user_update, user_delete, token_create, token_delete
`user`	string	否	按用户名筛选
`page`	integer	否	页码，默认 1
`limit`	integer	否	每页数量，默认 50，最大 200

响应: { "data": [{ "id", "timestamp", "user_id", "username", "action", "method", "path", "token_name", "details", "result" }], "total", "page", "limit" }

🔐 认证登录 API 文档

后台登录获取 Session Token，用于后续管理操作

POST /admin/login

管理员/用户登录，返回 Session Token（有效期 8 小时）

字段	类型	必填	说明
`username`	string	是 *	用户名
`password`	string	是 *	密码

请求示例

curl -X POST https://bolt-tools.pages.dev/admin/login   -H "Content-Type: application/json"   -d '{ "username": "pipi", "password": "your-password" }'

成功响应

{
  "session_token": "67cbafad3f0a0e1072c2b4015c4feec3...",
  "username": "pipi",
  "role": "admin"
}

失败响应

{ "error": "Invalid credentials" }

后续请求使用方式

curl https://bolt-tools.pages.dev/admin/users   -H "Authorization: Bearer 67cbafad3f0a0e10..."

两种认证方式

方式	Header	用途
Session Token	`Authorization: Bearer xxx`	管理后台操作（/admin/* 路由）
API Token	`X-Api-Key: xxx`	外部 API 写操作（/api/bolts POST/PUT/DELETE）

🔧 WebToolkit 后台管理系统

🔧 WebToolkit

螺丝管理

欢迎使用 WebToolkit 后台管理系统

新增螺栓

螺栓列表

批量导入

API Token 管理

生成 API Token

用户管理

添加用户

编辑用户

操作日志

API 模块

🔩 螺丝管理 API 文档

认证方式

公开端点

认证端点（需要 X-Api-Key）

响应格式

错误码

👥 用户管理 API 文档

🔑 Token 管理 API 文档

📋 操作日志 API 文档

🔐 认证登录 API 文档

两种认证方式