nepiedg
1eab1b99c1
- Rename all QINIU_* config/code/docs to OSS_* to match actual Alibaba Cloud OSS - Refactor upload module from internal/common/qiniu to internal/common/upload - Add backend proxy upload endpoint (POST /api/admin/marketing/upload) to avoid CORS - Auto-generate compressed thumbnail (800px, JPEG 80%) on admin image upload - Add dev-login endpoint (POST /api/v1/auth/dev-login) for H5 debugging - Add imageutil package for server-side image resizing Made-with: Cursor
45 lines
912 B
Markdown
45 lines
912 B
Markdown
# 公共说明
|
||
|
||
本目录存放所有小程序共用的接口约定与调用方式，避免每个子系统重复描述。
|
||
|
||
## 基础信息
|
||
|
||
- 接口前缀：`/api/v1`
|
||
- 健康检查：`GET /healthz` → `{"status":"ok"}`
|
||
|
||
## 通用响应结构
|
||
|
||
本项目所有接口使用统一 JSON 结构（见：`docs/common/response.md`）：
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "success",
|
||
"data": {}
|
||
}
|
||
```
|
||
|
||
## 认证方式
|
||
|
||
除登录接口外，其他接口都需要携带登录后返回的 `session_key`（见：`docs/common/auth.md`）。
|
||
|
||
## 上传（阿里云 OSS 直传）
|
||
|
||
- `docs/common/upload_qiniu.md`
|
||
|
||
## 微信公众号
|
||
|
||
- `docs/common/wechat_official.md`
|
||
|
||
## Redis
|
||
|
||
- `docs/common/redis.md`
|
||
|
||
## 自动化部署（非 Docker）
|
||
|
||
- `docs/common/deploy_ci.md`
|
||
|
||
## 后端开发规范
|
||
|
||
- `docs/common/backend_convention.md`（编码风格、模块分层、命名约定、接口规范、新增模块流程等）
|