| 变量名 | 说明 |
|---|---|
| SECRETID / SECRETKEY | 腾讯云 API 密钥,需具备 COS 与云开发权限 |
| Bucket | COS 存储桶(如 example-1250000000) |
| Region | COS 所在地域(如 ap-shanghai) |
| uploadDir | COS 上传目录(如 nike-shangma) |
| Claudid | 云开发环境 ID |
| tableName | 云开发集合名称 |
| ADMIN_USERNAME / ADMIN_PASSWORD | 管理后台账号、密码 |
| SESSION_SECRET | Session 加密密钥 |
| APPID | 小程序 APPID,用于二维码 |
| MSG_CHECK_API_KEY | 敏感词检测 OpenAI API Key |
| MSG_CHECK_BASE_URL | 敏感词检测服务 BaseURL |
| MSG_CHECK_MODEL | 敏感词检测使用的模型名称(如 deepseek-v3) |
环境配置
.env 中需提供以下参数
上传接口
POST /api/upload
Content-Type: multipart/form-data
请求字段
| 字段 | 类型 | 说明 |
|---|---|---|
| userCode | string | 必填,用户编号,仅限字母+数字 |
| name | string | 必填,用户名称 |
| slogan | string | 可选,跑步宣言 |
| shoeModel | string | 可选,选择的鞋型 |
| runRoute | string | 可选,跑步线路 |
| remark | string | 可选,补充备注 |
| file | file | 必填,上传的视频 (≤20MB,需为视频格式) |
成功响应示例
{
"code": 0,
"message": "上传成功",
"data": {
"userCode": "KF001",
"name": "张三",
"slogan": "跑出自我",
"shoeModel": "Nike Pegasus",
"runRoute": "橘子洲头夜跑",
"remark": "可选备注",
"fileUrl": "https://.cos..myqcloud.com/...",
"fileCode": "自动生成的 20 位编码",
"fileType": "video",
"appId": "wxf330df0a852decdf",
"qrcodeUrl": "https://web.skyelook.com/kf/nike-shangma-h5/index.html#/?code=FILE_CODE",
"createdAt": "2025-11-07T10:00:00.000Z"
}
}
查询接口
GET /api/records?userCode=用户编号
Query 参数:userCode (必填,字母+数字)
成功响应示例
{
"code": 0,
"message": "查询成功",
"data": {
"userCode": "KF001",
"name": "张三",
"slogan": "跑出自我",
"shoeModel": "Nike Pegasus",
"runRoute": "橘子洲头夜跑",
"remark": "备注信息",
"fileUrl": "https://...",
"fileCode": "abc123...",
"fileType": "video",
"appId": "wxf330df0a852decdf",
"qrcodeUrl": "https://web.skyelook.com/kf/nike-shangma-h5/index.html#/?code=abc123",
"createdAt": "2025-11-07T10:00:00.000Z"
}
}
文件详情接口
GET /api/files/{fileCode}
Path 参数:fileCode(必填)
成功响应示例
{
"code": 0,
"message": "查询成功",
"data": {
"userCode": "KF001",
"name": "张三",
"slogan": "跑出自我",
"shoeModel": "Nike Pegasus",
"runRoute": "橘子洲头夜跑",
"remark": "备注信息",
"fileUrl": "https://...",
"fileCode": "abc123...",
"fileType": "video",
"appId": "wxf330df0a852decdf",
"qrcodeUrl": "https://web.skyelook.com/kf/nike-shangma-h5/index.html#/?code=abc123",
"createdAt": "2025-11-07T10:00:00.000Z"
}
}
管理后台
路径:/admin · 支持视频预览
- 支持分页、模糊查询(用户编号 / 姓名 / 文件编码)
- 可新增 / 编辑 / 删除记录,自动写入云开发集合
- 仅支持视频上传,fileCode 长度 ≤ 20,自动生成可自定义
- 列表直接预览视频内容,便于审核
敏感词检测
POST /api/msg-check
Content-Type: application/json
请求示例
{
"text": "nike 牛逼"
}
无敏感词响应
{
"status": true,
"msg": "",
"code": 200,
"message": "检测通过"
}
包含敏感词响应
{
"status": false,
"msg": "包含敏感词",
"code": 202,
"message": "包含敏感词"
}
缺少 text 示例
{
"status": false,
"msg": "缺少 text 参数",
"code": 400,
"message": "缺少 text 参数"
}