# 玩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 ```