# 玩Android API 测试计划

## 基本信息
- **测试时间**: 2026-03-17 20:30
- **测试环境**: Ubuntu Linux
- **Base URL**: https://www.wanandroid.com
- **数据源**: wanapi.md (API文档)
- **测试目的**: 为移动端App开发提供完整的API测试文档

## API分类统计

根据 `wanapi.md` 文档，API共分为以下类别：

### 1. 2024-05-26 新增API (4个)
- 鸿蒙专栏 `/harmony/index/json`
- 首页热门-问答 `/popular/wenda/json`
- 首页热门-专栏 `/popular/column/json`
- 首页热门-路线 `/popular/route/json`

### 2. 首页相关API (5个)
- 首页文章列表 `/article/list/{页码}/json`
- 首页Banner `/banner/json`
- 常用网站 `/friend/json`
- 搜索热词 `/hotkey/json`
- 置顶文章 `/article/top/json`

### 3. 体系相关API (3个)
- 体系数据 `/tree/json`
- 体系下的文章 `/article/list/{页码}/json?cid={id}`
- 按作者搜文章 `/article/list/{页码}/json?author={name}`

### 4. 导航相关API (1个)
- 导航数据 `/navi/json`

### 5. 项目相关API (2个)
- 项目分类 `/project/tree/json`
- 项目列表 `/project/list/{页码}/json?cid={id}`

### 6. 登录/注册/退出API (3个)
- 登录 `/user/login` (POST)
- 注册 `/user/register` (POST)
- 退出 `/user/logout/json` (GET)

### 7. 收藏相关API (9个，需登录)
- 收藏文章列表 `/lg/collect/list/{页码}/json`
- 收藏站内文章 `/lg/collect/{文章id}/json`
- 收藏站外文章 `/lg/collect/add/json`
- 编辑收藏文章 `/lg/collect/user_article/update/{文章id}/json`
- 取消收藏（文章列表） `/lg/uncollect_originId/{文章id}/json`
- 取消收藏（我的收藏页） `/lg/uncollect/{收藏id}/json`
- 收藏网站列表 `/lg/collect/usertools/json`
- 收藏网址 `/lg/collect/addtool/json`
- 编辑收藏网站 `/lg/collect/updatetool/json`
- 删除收藏网站 `/lg/collect/deletetool/json`

### 8. 搜索API (1个)
- 文章搜索 `/article/query/{页码}/json` (POST)

### 9. 积分相关API (3个)
- 积分排行榜 `/coin/rank/{页码}/json`
- 个人积分信息 `/lg/coin/userinfo/json` (需登录)
- 个人积分列表 `/lg/coin/list/{页码}/json` (需登录)

### 10. 广场相关API (5个)
- 广场文章列表 `/user_article/list/{页码}/json`
- 分享人文章列表 `/user/{用户id}/share_articles/{页码}/json`
- 我的分享文章 `/user/lg/private_articles/{页码}/json` (需登录)
- 删除我的分享 `/lg/user_article/delete/{文章id}/json` (需登录)
- 分享文章 `/lg/user_article/add/json` (需登录)

### 11. 问答相关API (2个)
- 问答列表 `/wenda/list/{pageId}/json`
- 问答评论列表 `/wenda/comments/{问答id}/json`

### 12. 个人信息API (1个，需登录)
- 个人信息详情 `/user/lg/userinfo/json`

### 13. 站内消息API (3个，需登录)
- 未读消息数量 `/message/lg/count_unread/json`
- 已读消息列表 `/message/lg/readed_list/{页码}/json`
- 未读消息列表 `/message/lg/unread_list/{页码}/json`

### 14. 公众号相关API (3个)
- 公众号列表 `/wxarticle/chapters/json`
- 公众号历史文章 `/wxarticle/list/{公众号id}/{页码}/json`
- 公众号文章搜索 `/wxarticle/list/{公众号id}/{页码}/json?k={关键词}`

### 15. 最新项目API (1个)
- 最新项目列表 `/article/listproject/{页码}/json`

### 16. 工具/教程相关API (3个)
- 开发工具列表 `/tools/list/json`
- 教程列表 `/chapter/547/sublist/json`
- 单个教程文章 `/article/list/{页码}/json?cid={教程id}&order_type=1`

### 17. 待办工具API (TODO)
- 官方推荐使用 v2 版本

## 总计: 约 50 个API接口

## 测试策略

### 第一阶段：公开API测试（无需登录）
1. 首页相关API
2. 体系相关API
3. 导航相关API
4. 项目相关API
5. 搜索API
6. 积分排行榜（公开部分）
7. 广场文章列表
8. 问答相关API
9. 公众号相关API
10. 最新项目API
11. 工具/教程相关API

### 第二阶段：登录相关API测试
1. 注册测试账号
2. 登录获取Cookie
3. 测试需要登录的API
4. 验证Cookie传递机制

### 第三阶段：复杂场景测试
1. API调用顺序测试
2. 分页参数测试
3. 错误处理测试
4. 边界条件测试

## 输出文档格式

每个API测试记录将包含：
1. **API基本信息**：名称、地址、方法
2. **请求参数**：路径参数、查询参数、请求体
3. **请求示例**：完整的curl命令
4. **响应数据**：完整的响应体（JSON格式）
5. **响应解析**：关键字段说明
6. **注意事项**：特殊处理、边界条件
7. **测试时间**：测试执行时间戳

## 文件命名规范
- 主文档：`wanandroid_api_test_results.md`
- 分类文档：`wanandroid_api_首页测试.md`、`wanandroid_api_登录测试.md` 等
- 原始响应数据：`responses/` 目录下按API名称保存

开始测试时间：2026-03-17 20:30