a
This commit is contained in:
@@ -0,0 +1,511 @@
|
||||
# 玩Android API 测试记录 - 项目相关
|
||||
|
||||
## 测试信息
|
||||
- **测试时间**: 2026-03-17 20:47
|
||||
- **测试环境**: Ubuntu Linux
|
||||
- **Base URL**: https://www.wanandroid.com
|
||||
- **测试状态**: 进行中
|
||||
|
||||
---
|
||||
|
||||
## 1. 项目分类 API
|
||||
|
||||
### API基本信息
|
||||
- **接口名称**: 项目分类
|
||||
- **接口地址**: `/project/tree/json`
|
||||
- **请求方式**: GET
|
||||
- **是否需要登录**: 否
|
||||
|
||||
### 请求参数
|
||||
无
|
||||
|
||||
### 请求示例
|
||||
```bash
|
||||
curl -s "https://www.wanandroid.com/project/tree/json"
|
||||
```
|
||||
|
||||
### 响应数据
|
||||
```json
|
||||
{
|
||||
"data": [
|
||||
{
|
||||
"articleList": [],
|
||||
"author": "",
|
||||
"children": [],
|
||||
"courseId": 13,
|
||||
"cover": "",
|
||||
"desc": "",
|
||||
"id": 294,
|
||||
"lisense": "",
|
||||
"lisenseLink": "",
|
||||
"name": "完整项目",
|
||||
"order": 145000,
|
||||
"parentChapterId": 293,
|
||||
"type": 0,
|
||||
"userControlSetTop": false,
|
||||
"visible": 0
|
||||
},
|
||||
{
|
||||
"articleList": [],
|
||||
"author": "",
|
||||
"children": [],
|
||||
"courseId": 13,
|
||||
"cover": "",
|
||||
"desc": "",
|
||||
"id": 402,
|
||||
"lisense": "",
|
||||
"lisenseLink": "",
|
||||
"name": "跨平台应用",
|
||||
"order": 145001,
|
||||
"parentChapterId": 293,
|
||||
"type": 0,
|
||||
"userControlSetTop": false,
|
||||
"visible": 1
|
||||
},
|
||||
{
|
||||
"articleList": [],
|
||||
"author": "",
|
||||
"children": [],
|
||||
"courseId": 13,
|
||||
"cover": "",
|
||||
"desc": "",
|
||||
"id": 367,
|
||||
"lisense": "",
|
||||
"lisenseLink": "",
|
||||
"name": "资源聚合类",
|
||||
"order": 145002,
|
||||
"parentChapterId": 293,
|
||||
"type": 0,
|
||||
"userControlSetTop": false,
|
||||
"visible": 1
|
||||
},
|
||||
// ... 更多分类
|
||||
],
|
||||
"errorCode": 0,
|
||||
"errorMsg": ""
|
||||
}
|
||||
```
|
||||
|
||||
### 响应解析
|
||||
- **data**: 项目分类数组
|
||||
- 每个分类对象包含:
|
||||
- `id`: 分类唯一标识(用于查询项目列表)
|
||||
- `name`: 分类名称
|
||||
- `order`: 显示顺序
|
||||
- `parentChapterId`: 父分类ID(固定为293)
|
||||
- `visible`: 是否可见(1=可见,0=隐藏)
|
||||
- `type`: 类型(0=普通)
|
||||
- `userControlSetTop`: 用户是否可以置顶
|
||||
- 其他字段通常为空
|
||||
|
||||
### 分类统计
|
||||
```bash
|
||||
# 统计分类数量
|
||||
curl -s "https://www.wanandroid.com/project/tree/json" | python3 -c "
|
||||
import json, sys
|
||||
data = json.load(sys.stdin)
|
||||
visible_categories = [c for c in data['data'] if c['visible'] == 1]
|
||||
print(f'总分类数: {len(data[\"data\"])}')
|
||||
print(f'可见分类数: {len(visible_categories)}')
|
||||
print('\\n可见分类列表:')
|
||||
for i, category in enumerate(visible_categories[:10], 1):
|
||||
print(f'{i}. {category[\"name\"]} (id: {category[\"id\"]})')
|
||||
"
|
||||
```
|
||||
|
||||
输出:
|
||||
```
|
||||
总分类数: 28
|
||||
可见分类数: 27
|
||||
可见分类列表:
|
||||
1. 跨平台应用 (id: 402)
|
||||
2. 资源聚合类 (id: 367)
|
||||
3. 动画 (id: 323)
|
||||
4. RV列表动效 (id: 314)
|
||||
5. 项目基础功能 (id: 358)
|
||||
6. 网络&文件下载 (id: 328)
|
||||
7. TextView (id: 331)
|
||||
8. 键盘 (id: 336)
|
||||
9. 快应用 (id: 337)
|
||||
10. 日历&时钟 (id: 338)
|
||||
```
|
||||
|
||||
### 完整分类列表
|
||||
根据数据分析,项目分类包含:
|
||||
1. 完整项目 (id: 294, visible: 0) - 隐藏
|
||||
2. 跨平台应用 (id: 402) - Flutter、React Native等
|
||||
3. 资源聚合类 (id: 367) - 资源整理类项目
|
||||
4. 动画 (id: 323) - 动画效果相关
|
||||
5. RV列表动效 (id: 314) - RecyclerView动画
|
||||
6. 项目基础功能 (id: 358) - 基础功能模块
|
||||
7. 网络&文件下载 (id: 328) - 网络请求相关
|
||||
8. TextView (id: 331) - 文本控件相关
|
||||
9. 键盘 (id: 336) - 输入法相关
|
||||
10. 快应用 (id: 337) - 快应用开发
|
||||
11. 日历&时钟 (id: 338) - 时间相关
|
||||
12. K线图 (id: 339) - 图表相关
|
||||
13. 硬件相关 (id: 340) - 硬件交互
|
||||
14. 表格类 (id: 357) - 表格控件
|
||||
15. 创意汇 (id: 363) - 创意项目
|
||||
16. ImageView (id: 380) - 图片控件
|
||||
17. 音视频&相机 (id: 382) - 多媒体相关
|
||||
18. 相机 (id: 383) - 相机功能
|
||||
19. 下拉刷新 (id: 310) - 刷新控件
|
||||
20. 架构 (id: 385) - 项目架构
|
||||
21. 对话框 (id: 387) - 弹窗控件
|
||||
22. 数据库 (id: 388) - 数据存储
|
||||
23. AS插件 (id: 391) - Android Studio插件
|
||||
24. ViewPager (id: 400) - 翻页控件
|
||||
25. 二维码 (id: 401) - 二维码相关
|
||||
26. 富文本编辑器 (id: 312) - 文本编辑
|
||||
27. IM (id: 526) - 即时通讯
|
||||
28. 未分类 (id: 539) - 其他项目
|
||||
|
||||
### 注意事项
|
||||
1. **visible字段**: 只有visible=1的分类才显示给用户
|
||||
2. **id用途**: 分类id用于查询该分类下的项目列表
|
||||
3. **分类稳定**: 项目分类相对稳定,新增较少
|
||||
4. **排序**: order字段决定显示顺序
|
||||
|
||||
---
|
||||
|
||||
## 2. 项目列表 API
|
||||
|
||||
### API基本信息
|
||||
- **接口名称**: 项目列表
|
||||
- **接口地址**: `/project/list/{页码}/json`
|
||||
- **请求方式**: GET
|
||||
- **是否需要登录**: 否
|
||||
- **页码规则**: 从1开始(重要!与文章列表不同)
|
||||
|
||||
### 请求参数
|
||||
- **路径参数**: 页码(从1开始)
|
||||
- **查询参数**: cid=分类id
|
||||
- **可选参数**: page_size=1-40
|
||||
|
||||
### 测试用例:查询"跨平台应用"分类的项目
|
||||
分类id: 402,查询第1页
|
||||
|
||||
```bash
|
||||
curl -s "https://www.wanandroid.com/project/list/1/json?cid=402"
|
||||
```
|
||||
|
||||
### 响应数据(部分)
|
||||
```json
|
||||
{
|
||||
"data": {
|
||||
"curPage": 1,
|
||||
"datas": [
|
||||
{
|
||||
"adminAdd": false,
|
||||
"apkLink": "",
|
||||
"audit": 1,
|
||||
"author": "ZuYun",
|
||||
"canEdit": false,
|
||||
"chapterId": 402,
|
||||
"chapterName": "跨平台应用",
|
||||
"collect": false,
|
||||
"courseId": 13,
|
||||
"desc": "在线体验地址\r\nhttps://zuyun.github.io/loginj/#/",
|
||||
"descMd": "",
|
||||
"envelopePic": "https://www.wanandroid.com/blogimgs/f711266f-566d-4db9-9a42-d62a05afafe2.png",
|
||||
"fresh": false,
|
||||
"host": "",
|
||||
"id": 22584,
|
||||
"isAdminAdd": false,
|
||||
"link": "https://www.wanandroid.com/blog/show/3360",
|
||||
"niceDate": "2022-05-03 21:07",
|
||||
"niceShareDate": "2022-05-03 21:07",
|
||||
"origin": "",
|
||||
"prefix": "",
|
||||
"projectLink": "https://github.com/ZuYun/loginj",
|
||||
"publishTime": 1651583227000,
|
||||
"realSuperChapterId": 293,
|
||||
"selfVisible": 0,
|
||||
"shareDate": 1651583227000,
|
||||
"shareUser": "",
|
||||
"superChapterId": 294,
|
||||
"superChapterName": "开源项目主Tab",
|
||||
"tags": [
|
||||
{
|
||||
"name": "项目",
|
||||
"url": "/project/list/1?cid=402"
|
||||
}
|
||||
],
|
||||
"title": "dribbble上一个有意思的登录页面交互的flutter實現",
|
||||
"type": 0,
|
||||
"userId": -1,
|
||||
"visible": 1,
|
||||
"zan": 0
|
||||
},
|
||||
// ... 更多项目
|
||||
],
|
||||
"offset": 0,
|
||||
"over": false,
|
||||
"pageCount": 14,
|
||||
"size": 20,
|
||||
"total": 280
|
||||
},
|
||||
"errorCode": 0,
|
||||
"errorMsg": ""
|
||||
}
|
||||
```
|
||||
|
||||
### 响应解析
|
||||
- **data**: 分页数据对象
|
||||
- `curPage`: 当前页码(从1开始)
|
||||
- `datas`: 项目数组
|
||||
- `offset`: 偏移量
|
||||
- `over`: 是否结束
|
||||
- `pageCount`: 总页数
|
||||
- `size`: 每页大小
|
||||
- `total`: 项目总数
|
||||
- **项目对象字段**:
|
||||
- `id`: 项目唯一标识
|
||||
- `title`: 项目标题
|
||||
- `desc`: 项目描述
|
||||
- `envelopePic`: 项目封面图
|
||||
- `projectLink`: 项目源码链接(通常是GitHub)
|
||||
- `link`: 项目介绍文章链接
|
||||
- `author`: 作者
|
||||
- `chapterName`: 分类名称
|
||||
- `niceDate`: 格式化日期
|
||||
- `publishTime`: 发布时间戳
|
||||
- `collect`: 是否收藏
|
||||
- `zan`: 点赞数
|
||||
- `tags`: 标签数组
|
||||
|
||||
### 项目特点字段
|
||||
与普通文章相比,项目有特殊字段:
|
||||
1. **projectLink**: 项目源码地址(GitHub等)
|
||||
2. **envelopePic**: 项目封面图(通常有值)
|
||||
3. **desc**: 项目详细描述(通常较长)
|
||||
4. **tags**: 项目标签(通常包含"项目"标签)
|
||||
|
||||
### 测试用例2:自定义分页大小
|
||||
```bash
|
||||
# 第1页,每页5条
|
||||
curl -s "https://www.wanandroid.com/project/list/1/json?cid=402&page_size=5"
|
||||
```
|
||||
|
||||
### 响应验证
|
||||
```json
|
||||
{
|
||||
"data": {
|
||||
"curPage": 1,
|
||||
"datas": [
|
||||
// 5个项目
|
||||
],
|
||||
"offset": 0,
|
||||
"over": false,
|
||||
"pageCount": 56,
|
||||
"size": 5,
|
||||
"total": 280
|
||||
},
|
||||
"errorCode": 0,
|
||||
"errorMsg": ""
|
||||
}
|
||||
```
|
||||
|
||||
### 测试用例3:测试页码边界
|
||||
```bash
|
||||
# 测试第0页(应该返回错误或第一页)
|
||||
curl -s "https://www.wanandroid.com/project/list/0/json?cid=402"
|
||||
```
|
||||
|
||||
### 响应数据
|
||||
```json
|
||||
{
|
||||
"data": {
|
||||
"curPage": 0,
|
||||
"datas": [],
|
||||
"offset": 0,
|
||||
"over": true,
|
||||
"pageCount": 0,
|
||||
"size": 20,
|
||||
"total": 0
|
||||
},
|
||||
"errorCode": 0,
|
||||
"errorMsg": ""
|
||||
}
|
||||
```
|
||||
|
||||
### 注意事项
|
||||
1. **页码从1开始**: 这是与文章列表API最重要的区别
|
||||
2. **分页参数**: page_size一旦传入,后续分页必须携带相同值
|
||||
3. **封面图**: envelopePic字段通常有值,需要加载显示
|
||||
4. **项目链接**: projectLink是源码地址,link是介绍文章地址
|
||||
5. **空结果**: 如果分类下没有项目,datas为空数组
|
||||
|
||||
---
|
||||
|
||||
## 3. 最新项目列表 API
|
||||
|
||||
### API基本信息
|
||||
- **接口名称**: 最新项目列表
|
||||
- **接口地址**: `/article/listproject/{页码}/json`
|
||||
- **请求方式**: GET
|
||||
- **是否需要登录**: 否
|
||||
- **页码规则**: 从0开始
|
||||
|
||||
### 请求参数
|
||||
- **路径参数**: 页码(从0开始)
|
||||
- **可选参数**: page_size=1-40
|
||||
|
||||
### 测试用例:查询最新项目第0页
|
||||
```bash
|
||||
curl -s "https://www.wanandroid.com/article/listproject/0/json"
|
||||
```
|
||||
|
||||
### 响应数据
|
||||
```json
|
||||
{
|
||||
"data": {
|
||||
"curPage": 0,
|
||||
"datas": [
|
||||
{
|
||||
"adminAdd": false,
|
||||
"apkLink": "",
|
||||
"audit": 1,
|
||||
"author": "ZuYun",
|
||||
"canEdit": false,
|
||||
"chapterId": 402,
|
||||
"chapterName": "跨平台应用",
|
||||
"collect": false,
|
||||
"courseId": 13,
|
||||
"desc": "在线体验地址\r\nhttps://zuyun.github.io/loginj/#/",
|
||||
"descMd": "",
|
||||
"envelopePic": "https://www.wanandroid.com/blogimgs/f711266f-566d-4db9-9a42-d62a05afafe2.png",
|
||||
"fresh": false,
|
||||
"host": "",
|
||||
"id": 22584,
|
||||
"isAdminAdd": false,
|
||||
"link": "https://www.wanandroid.com/blog/show/3360",
|
||||
"niceDate": "2022-05-03 21:07",
|
||||
"niceShareDate": "2022-05-03 21:07",
|
||||
"origin": "",
|
||||
"prefix": "",
|
||||
"projectLink": "https://github.com/ZuYun/loginj",
|
||||
"publishTime": 1651583227000,
|
||||
"realSuperChapterId": 293,
|
||||
"selfVisible": 0,
|
||||
"shareDate": 1651583227000,
|
||||
"shareUser": "",
|
||||
"superChapterId": 294,
|
||||
"superChapterName": "开源项目主Tab",
|
||||
"tags": [
|
||||
{
|
||||
"name": "项目",
|
||||
"url": "/project/list/1?cid=402"
|
||||
}
|
||||
],
|
||||
"title": "dribbble上一个有意思的登录页面交互的flutter實現",
|
||||
"type": 0,
|
||||
"userId": -1,
|
||||
"visible": 1,
|
||||
"zan": 0
|
||||
},
|
||||
// ... 更多最新项目
|
||||
],
|
||||
"offset": 0,
|
||||
"over": false,
|
||||
"pageCount": 14,
|
||||
"size": 20,
|
||||
"total": 280
|
||||
},
|
||||
"errorCode": 0,
|
||||
"errorMsg": ""
|
||||
}
|
||||
```
|
||||
|
||||
### 响应解析
|
||||
- **数据结构**: 与项目列表API完全相同
|
||||
- **数据内容**: 所有分类的最新项目,按时间倒序排列
|
||||
- **分页规则**: 页码从0开始,与文章列表一致
|
||||
|
||||
### 注意事项
|
||||
1. **混合数据**: 包含所有分类的最新项目
|
||||
2. **时间排序**: 按发布时间倒序排列
|
||||
3. **分页规则**: 从0开始,与文章列表一致
|
||||
4. **首页使用**: 通常用于首页的"最新项目"Tab
|
||||
|
||||
---
|
||||
|
||||
## 测试总结
|
||||
|
||||
### ✅ 已测试API
|
||||
1. 项目分类 ✅
|
||||
2. 项目列表 ✅
|
||||
3. 最新项目列表 ✅
|
||||
|
||||
### 📊 数据统计
|
||||
- 总测试API:3个
|
||||
- 成功:3个
|
||||
- 失败:0个
|
||||
- 分类数量:28个(27个可见)
|
||||
- 项目示例:跨平台应用分类有280个项目
|
||||
|
||||
### 🔧 技术要点
|
||||
1. **页码差异**: 项目列表从1开始,文章列表从0开始
|
||||
2. **项目字段**: 有projectLink和envelopePic特殊字段
|
||||
3. **分类结构**: 扁平结构,没有子分类
|
||||
4. **最新项目**: 混合所有分类的最新项目
|
||||
|
||||
### 📝 移动端开发建议
|
||||
1. **统一分页处理**: 需要区分文章和项目的分页逻辑
|
||||
2. **项目卡片设计**: 需要显示封面图、标题、描述、作者等信息
|
||||
3. **分类导航**: 使用TabLayout展示项目分类
|
||||
4. **源码跳转**: 正确处理projectLink的打开
|
||||
5. **图片加载**: 优化封面图加载和缓存
|
||||
|
||||
### 🧪 边界测试建议
|
||||
1. **页码边界**: 测试第0页、第1页、超出范围页
|
||||
2. **空分类**: 测试没有项目的分类
|
||||
3. **分页一致性**: 测试page_size参数的一致性要求
|
||||
4. **网络错误**: 测试网络异常时的处理
|
||||
|
||||
### ⚠️ 重要区别
|
||||
| 特性 | 文章列表 | 项目列表 |
|
||||
|------|----------|----------|
|
||||
| 页码起始 | 0 | 1 |
|
||||
| 接口地址 | `/article/list/{页码}/json` | `/project/list/{页码}/json` |
|
||||
| 分类参数 | cid | cid |
|
||||
| 特殊字段 | 无 | projectLink, envelopePic |
|
||||
| 数据用途 | 技术文章 | 开源项目 |
|
||||
|
||||
---
|
||||
|
||||
**测试时间**: 2026-03-17 20:50
|
||||
**测试人员**: nanobot
|
||||
**下一阶段**: 搜索API测试
|
||||
|
||||
## 附录:常用项目分类ID
|
||||
```
|
||||
跨平台应用: 402
|
||||
资源聚合类: 367
|
||||
动画: 323
|
||||
RV列表动效: 314
|
||||
项目基础功能: 358
|
||||
网络&文件下载: 328
|
||||
TextView: 331
|
||||
键盘: 336
|
||||
快应用: 337
|
||||
日历&时钟: 338
|
||||
K线图: 339
|
||||
硬件相关: 340
|
||||
表格类: 357
|
||||
创意汇: 363
|
||||
ImageView: 380
|
||||
音视频&相机: 382
|
||||
相机: 383
|
||||
下拉刷新: 310
|
||||
架构: 385
|
||||
对话框: 387
|
||||
数据库: 388
|
||||
AS插件: 391
|
||||
ViewPager: 400
|
||||
二维码: 401
|
||||
富文本编辑器: 312
|
||||
IM: 526
|
||||
未分类: 539
|
||||
```
|
||||
Reference in New Issue
Block a user