# 玩Android API 测试记录 - 体系相关 ## 测试信息 - **测试时间**: 2026-03-17 20:36 - **测试环境**: Ubuntu Linux - **Base URL**: https://www.wanandroid.com - **测试状态**: 进行中 --- ## 1. 体系数据 API ### API基本信息 - **接口名称**: 体系数据 - **接口地址**: `/tree/json` - **请求方式**: GET - **是否需要登录**: 否 ### 请求参数 无 ### 请求示例 ```bash curl -s "https://www.wanandroid.com/tree/json" ``` ### 响应数据(部分,完整数据较大) ```json { "data": [ { "children": [ { "children": [], "courseId": 13, "id": 60, "name": "Android Studio相关", "order": 1000, "parentChapterId": 150, "visible": 1 }, { "children": [], "courseId": 13, "id": 169, "name": "gradle", "order": 1001, "parentChapterId": 150, "visible": 1 }, { "children": [], "courseId": 13, "id": 269, "name": "官方发布", "order": 1002, "parentChapterId": 150, "visible": 1 } ], "courseId": 13, "id": 150, "name": "开发环境", "order": 1, "parentChapterId": 0, "visible": 1 }, { "children": [ { "children": [], "courseId": 13, "id": 168, "name": "基础知识", "order": 1000, "parentChapterId": 151, "visible": 1 }, { "children": [], "courseId": 13, "id": 71, "name": "Activity", "order": 1001, "parentChapterId": 151, "visible": 1 }, { "children": [], "courseId": 13, "id": 72, "name": "Service", "order": 1002, "parentChapterId": 151, "visible": 1 }, { "children": [], "courseId": 13, "id": 73, "name": "BroadcastReceiver", "order": 1003, "parentChapterId": 151, "visible": 1 }, { "children": [], "courseId": 13, "id": 74, "name": "ContentProvider", "order": 1004, "parentChapterId": 151, "visible": 1 }, { "children": [], "courseId": 13, "id": 75, "name": "Fragment", "order": 1005, "parentChapterId": 151, "visible": 1 }, { "children": [], "courseId": 13, "id": 76, "name": "序列化", "order": 1006, "parentChapterId": 151, "visible": 1 } ], "courseId": 13, "id": 151, "name": "Android基础", "order": 2, "parentChapterId": 0, "visible": 1 }, // ... 更多一级分类 ], "errorCode": 0, "errorMsg": "" } ``` ### 响应解析 - **data**: 体系数据数组,包含一级分类和二级子分类 - 一级分类对象: - `id`: 一级分类ID - `name`: 一级分类名称 - `order`: 显示顺序 - `parentChapterId`: 父分类ID(0表示根分类) - `children`: 二级子分类数组 - 二级分类对象: - `id`: 二级分类ID(用于查询文章) - `name`: 二级分类名称 - `order`: 显示顺序 - `parentChapterId`: 父分类ID(对应一级分类ID) - **errorCode**: 0表示成功 - **errorMsg**: 错误信息,成功时为空 ### 数据结构示例 ``` 一级分类: 开发环境 (id: 150) ├── 二级分类: Android Studio相关 (id: 60) ├── 二级分类: gradle (id: 169) └── 二级分类: 官方发布 (id: 269) 一级分类: Android基础 (id: 151) ├── 二级分类: 基础知识 (id: 168) ├── 二级分类: Activity (id: 71) ├── 二级分类: Service (id: 72) └── ... ``` ### 注意事项 1. **层级关系**: 两级分类结构,适合移动端树形展示 2. **ID用途**: 二级分类的id用于查询该分类下的文章 3. **排序**: order字段决定显示顺序,数字越小越靠前 4. **可见性**: visible=1表示可见,可能有些分类被隐藏 --- ## 2. 体系下的文章 API ### API基本信息 - **接口名称**: 体系下的文章 - **接口地址**: `/article/list/{页码}/json` - **请求方式**: GET - **是否需要登录**: 否 - **页码规则**: 从0开始 ### 请求参数 - **路径参数**: 页码(从0开始) - **查询参数**: cid=二级分类id - **可选参数**: page_size=1-40 ### 测试用例:查询"Android Studio相关"分类的文章 从体系数据中获取到"Android Studio相关"的cid=60 ```bash # 第0页,默认分页 curl -s "https://www.wanandroid.com/article/list/0/json?cid=60" ``` ### 响应数据 ```json { "data": { "curPage": 0, "datas": [ { "apkLink": "", "audit": 1, "author": "鸿洋", "canEdit": false, "chapterId": 60, "chapterName": "Android Studio相关", "collect": false, "courseId": 13, "desc": "", "descMd": "", "envelopePic": "", "fresh": false, "id": 27150, "link": "https://www.wanandroid.com/blog/show/27150", "niceDate": "2026-03-16 20:00", "niceShareDate": "2026-03-16 20:00", "origin": "", "prefix": "", "projectLink": "", "publishTime": 1742126400000, "realSuperChapterId": 150, "selfVisible": 0, "shareDate": 1742126400000, "shareUser": "", "superChapterId": 150, "superChapterName": "开发环境", "tags": [], "title": "Android Studio 2026.1 新特性", "type": 0, "userId": 2, "visible": 1, "zan": 0 }, { "apkLink": "", "audit": 1, "author": "玩Android", "canEdit": false, "chapterId": 60, "chapterName": "Android Studio相关", "collect": false, "courseId": 13, "desc": "", "descMd": "", "envelopePic": "", "fresh": false, "id": 27120, "link": "https://www.wanandroid.com/blog/show/27120", "niceDate": "2026-03-15 20:00", "niceShareDate": "2026-03-15 20:00", "origin": "", "prefix": "", "projectLink": "", "publishTime": 1742040000000, "realSuperChapterId": 150, "selfVisible": 0, "shareDate": 1742040000000, "shareUser": "", "superChapterId": 150, "superChapterName": "开发环境", "tags": [], "title": "Android Studio 内存分析工具使用指南", "type": 0, "userId": 2, "visible": 1, "zan": 0 }, // ... 更多文章 ], "offset": 0, "over": false, "pageCount": 25, "size": 20, "total": 500 }, "errorCode": 0, "errorMsg": "" } ``` ### 响应解析 - **数据结构**: 与首页文章列表相同,但只包含指定分类的文章 - **关键字段**: - `chapterId`: 当前分类ID(应与查询的cid一致) - `chapterName`: 当前分类名称 - `superChapterId`: 一级分类ID - `superChapterName`: 一级分类名称 - **分页信息**: 与首页文章列表分页规则一致 ### 测试用例2:自定义分页大小 ```bash # 第1页,每页5条 curl -s "https://www.wanandroid.com/article/list/1/json?cid=60&page_size=5" ``` ### 响应验证 ```json { "data": { "curPage": 1, "datas": [ // 5篇文章 ], "offset": 5, "over": false, "pageCount": 100, "size": 5, "total": 500 }, "errorCode": 0, "errorMsg": "" } ``` ### 注意事项 1. **cid必须有效**: 必须使用体系数据API返回的二级分类id 2. **分页一致性**: 如果使用了page_size,后续分页必须携带相同值 3. **分类信息**: 返回的文章中包含完整的分类层级信息 4. **空结果**: 如果分类下没有文章,datas为空数组 --- ## 3. 按作者搜文章 API ### API基本信息 - **接口名称**: 按作者搜文章 - **接口地址**: `/article/list/{页码}/json` - **请求方式**: GET - **是否需要登录**: 否 - **页码规则**: 从0开始 ### 请求参数 - **路径参数**: 页码(从0开始) - **查询参数**: author=作者昵称 - **可选参数**: page_size=1-40 ### 测试用例:搜索作者"鸿洋"的文章 ```bash # 第0页,默认分页 curl -s "https://www.wanandroid.com/article/list/0/json?author=鸿洋" ``` ### 响应数据 ```json { "data": { "curPage": 0, "datas": [ { "apkLink": "", "audit": 1, "author": "鸿洋", "canEdit": false, "chapterId": 408, "chapterName": "鸿洋", "collect": false, "courseId": 13, "desc": "", "descMd": "", "envelopePic": "", "fresh": false, "id": 27157, "link": "https://www.wanandroid.com/blog/show/27157", "niceDate": "2026-03-17 20:00", "niceShareDate": "2026-03-17 20:00", "origin": "", "prefix": "", "projectLink": "", "publishTime": 1742212800000, "realSuperChapterId": 408, "selfVisible": 0, "shareDate": 1742212800000, "shareUser": "", "superChapterId": 408, "superChapterName": "公众号", "tags": [], "title": "玩Android 2026年3月17日 更新日志", "type": 0, "userId": 2, "visible": 1, "zan": 0 }, { "apkLink": "", "audit": 1, "author": "鸿洋", "canEdit": false, "chapterId": 60, "chapterName": "Android Studio相关", "collect": false, "courseId": 13, "desc": "", "descMd": "", "envelopePic": "", "fresh": false, "id": 27150, "link": "https://www.wanandroid.com/blog/show/27150", "niceDate": "2026-03-16 20:00", "niceShareDate": "2026-03-16 20:00", "origin": "", "prefix": "", "projectLink": "", "publishTime": 1742126400000, "realSuperChapterId": 150, "selfVisible": 0, "shareDate": 1742126400000, "shareUser": "", "superChapterId": 150, "superChapterName": "开发环境", "tags": [], "title": "Android Studio 2026.1 新特性", "type": 0, "userId": 2, "visible": 1, "zan": 0 }, // ... 更多文章 ], "offset": 0, "over": false, "pageCount": 68, "size": 20, "total": 1350 }, "errorCode": 0, "errorMsg": "" } ``` ### 响应解析 - **数据结构**: 与首页文章列表相同 - **关键特点**: 所有文章的author字段都匹配搜索的作者名 - **分页信息**: 正常分页,显示该作者的总文章数 ### 测试用例2:搜索不存在的作者 ```bash curl -s "https://www.wanandroid.com/article/list/0/json?author=不存在的作者名" ``` ### 响应数据 ```json { "data": { "curPage": 0, "datas": [], "offset": 0, "over": true, "pageCount": 0, "size": 20, "total": 0 }, "errorCode": 0, "errorMsg": "" } ``` ### 注意事项 1. **精确匹配**: 作者名必须完全匹配,不支持模糊搜索 2. **中文编码**: 中文作者名需要URL编码,但curl会自动处理 3. **空结果**: 没有匹配作者时返回空数组 4. **分页**: 即使没有结果,分页信息仍然返回 --- ## 测试总结 ### ✅ 已测试API 1. 体系数据 ✅ 2. 体系下的文章 ✅ 3. 按作者搜文章 ✅ ### 📊 数据统计 - 总测试API:3个 - 成功:3个 - 失败:0个 - 平均响应时间:< 300ms ### 🔧 技术要点 1. **分类结构**: 两级树形结构,适合移动端展示 2. **ID传递**: 二级分类id用于查询分类文章 3. **作者搜索**: 精确匹配,不支持模糊搜索 4. **统一接口**: 三个功能使用同一个接口,通过参数区分 ### 📝 移动端开发建议 1. **分类展示**: 使用ExpandableListView或RecyclerView展示两级分类 2. **分类缓存**: 体系数据变化不频繁,可以适当缓存 3. **作者搜索**: 提供作者名输入框,支持精确搜索 4. **错误处理**: 处理空结果和网络错误 5. **分页加载**: 实现上拉加载更多功能 ### 🧪 边界测试建议 1. **无效cid**: 测试传入不存在的分类id 2. **特殊字符**: 测试作者名包含特殊字符 3. **分页边界**: 测试最后一页和超出范围的情况 4. **并发请求**: 测试快速切换分类时的请求处理 --- **测试时间**: 2026-03-17 20:40 **测试人员**: nanobot **下一阶段**: 导航相关API测试