腾讯云 COS FastAPI Demo

基于 Python 和 FastAPI 实现的腾讯云对象存储 COS 对接示例。

功能特性

• 文件上传
• 文件下载
• 文件删除
• 文件列表查询
• 完整的错误处理和日志记录
• 自动生成的 API 文档

环境要求

• Python 3.8+
• 腾讯云账号及 COS 服务

安装步骤

1. 克隆项目
2. 安装依赖: pip install -r requirements.txt
3. 配置环境变量 (参考 .env.example)
4. 运行应用: uvicorn main:app --host 127.0.0.1 --port 8001 --reload

API 接口

• POST /upload/ - 上传文件
• GET /download/{file_name} - 下载文件
• DELETE /delete/{file_name} - 删除文件
• GET /list/ - 获取文件列表
• GET / - 健康检查
• GET /info - 应用信息

API 文档

启动应用后，可以通过以下地址访问自动生成的 API 文档：

• Swagger UI: http://127.0.0.1:8001/docs
• ReDoc: http://127.0.0.1:8001/redoc

项目结构

.
├── .env                 # 环境变量配置文件
├── .env.example         # 环境变量示例文件
├── config.py            # 配置加载模块
├── cos_client.py        # COS 客户端初始化
├── main.py              # 应用主入口
├── routes.py            # API 路由定义
├── test_api.py          # API 测试脚本
├── requirements.txt     # 项目依赖
├── README.md            # 项目说明
└── USAGE.md             # 详细使用说明

使用说明

详细使用说明请参考 USAGE.md 文件。