Files
nanocode/wanandroid/API_TEST_PLAN.md
T
Ubuntu 32b43f85bd a
2026-07-03 16:58:28 +08:00

4.7 KiB

玩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