Ubuntu
144 lines
4.7 KiB
Markdown
144 lines
4.7 KiB
Markdown
# 玩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 |