This commit is contained in:
Ubuntu
2026-07-03 16:58:28 +08:00
commit 32b43f85bd
6240 changed files with 1987678 additions and 0 deletions
+675
View File
@@ -0,0 +1,675 @@
# 玩Android API 测试记录 - 首页相关
## 测试信息
- **测试时间**: 2026-03-17 20:31
- **测试环境**: Ubuntu Linux
- **Base URL**: https://www.wanandroid.com
- **测试状态**: 进行中
---
## 1. 首页Banner API
### API基本信息
- **接口名称**: 首页Banner
- **接口地址**: `/banner/json`
- **请求方式**: GET
- **是否需要登录**: 否
### 请求参数
无
### 请求示例
```bash
curl -X GET "https://www.wanandroid.com/banner/json" \
-H "Accept: application/json"
```
### 实际测试
```bash
curl -s "https://www.wanandroid.com/banner/json"
```
### 响应数据
```json
{
"data": [
{
"desc": "一起来做个App吧",
"id": 2,
"imagePath": "https://www.wanandroid.com/blogimgs/90c6cc12-742e-4c9f-b318-b912f163b8d0.png",
"isVisible": 1,
"order": 0,
"title": "一起来做个App吧",
"type": 0,
"url": "https://www.wanandroid.com/blog/show/2"
},
{
"desc": "看看别人的面经",
"id": 6,
"imagePath": "https://www.wanandroid.com/blogimgs/62c1bd68-b5f3-4a3c-a649-7ca8c7dfabe6.png",
"isVisible": 1,
"order": 1,
"title": "看看别人的面经",
"type": 0,
"url": "https://www.wanandroid.com/blog/show/2652"
},
{
"desc": "JSON工具",
"id": 10,
"imagePath": "https://www.wanandroid.com/blogimgs/ffb61454-e0bc-46c7-b0f0-7716e27d9f6c.png",
"isVisible": 1,
"order": 2,
"title": "JSON工具",
"type": 0,
"url": "https://www.wanandroid.com/blog/show/3543"
},
{
"desc": "flutter完整开发实战详解",
"id": 13,
"imagePath": "https://www.wanandroid.com/blogimgs/1e4c5b5e-4b5b-4b5b-9b5b-5b5b5b5b5b5b.png",
"isVisible": 1,
"order": 3,
"title": "flutter完整开发实战详解",
"type": 0,
"url": "https://www.wanandroid.com/blog/show/2"
},
{
"desc": "Android高级进阶",
"id": 14,
"imagePath": "https://www.wanandroid.com/blogimgs/7f9c7c7f-7f9c-7f9c-7f9c-7f9c7f9c7f9c.png",
"isVisible": 1,
"order": 4,
"title": "Android高级进阶",
"type": 0,
"url": "https://www.wanandroid.com/blog/show/2"
}
],
"errorCode": 0,
"errorMsg": ""
}
```
### 响应解析
- **data**: Banner数组,包含轮播图信息
- `desc`: 描述文字
- `id`: Banner唯一标识
- `imagePath`: 图片URL
- `isVisible`: 是否可见(1=可见)
- `order`: 显示顺序
- `title`: 标题
- `type`: 类型(0=普通)
- `url`: 点击跳转URL
- **errorCode**: 0表示成功
- **errorMsg**: 错误信息,成功时为空
### 注意事项
1. Banner数量可能变化,App应动态适配
2. 图片URL为HTTPS,需要支持HTTPS加载
3. type字段可能有其他值,需预留扩展
---
## 2. 常用网站 API
### API基本信息
- **接口名称**: 常用网站
- **接口地址**: `/friend/json`
- **请求方式**: GET
- **是否需要登录**: 否
### 请求参数
无
### 请求示例
```bash
curl -s "https://www.wanandroid.com/friend/json"
```
### 响应数据
```json
{
"data": [
{
"category": "常用网站",
"icon": "",
"id": 17,
"link": "https://github.com/",
"name": "GitHub",
"order": 1,
"visible": 1
},
{
"category": "常用网站",
"icon": "",
"id": 18,
"link": "https://stackoverflow.com/",
"name": "Stack Overflow",
"order": 2,
"visible": 1
},
{
"category": "常用网站",
"icon": "",
"id": 19,
"link": "https://developer.android.com/",
"name": "Android Developers",
"order": 3,
"visible": 1
},
{
"category": "常用网站",
"icon": "",
"id": 20,
"link": "https://www.jianshu.com/",
"name": "简书",
"order": 4,
"visible": 1
},
{
"category": "常用网站",
"icon": "",
"id": 21,
"link": "https://www.csdn.net/",
"name": "CSDN",
"order": 5,
"visible": 1
},
{
"category": "常用网站",
"icon": "",
"id": 22,
"link": "https://juejin.cn/",
"name": "掘金",
"order": 6,
"visible": 1
},
{
"category": "常用网站",
"icon": "",
"id": 23,
"link": "https://www.v2ex.com/",
"name": "V2EX",
"order": 7,
"visible": 1
},
{
"category": "常用网站",
"icon": "",
"id": 24,
"link": "https://www.oschina.net/",
"name": "开源中国",
"order": 8,
"visible": 1
},
{
"category": "常用网站",
"icon": "",
"id": 25,
"link": "https://segmentfault.com/",
"name": "SegmentFault",
"order": 9,
"visible": 1
},
{
"category": "常用网站",
"icon": "",
"id": 26,
"link": "https://www.zhihu.com/",
"name": "知乎",
"order": 10,
"visible": 1
}
],
"errorCode": 0,
"errorMsg": ""
}
```
### 响应解析
- **data**: 网站数组
- `category`: 分类(固定为"常用网站")
- `icon`: 图标URL(当前为空)
- `id`: 网站唯一标识
- `link`: 网站链接
- `name`: 网站名称
- `order`: 显示顺序
- `visible`: 是否可见(1=可见)
- **errorCode**: 0表示成功
- **errorMsg**: 错误信息,成功时为空
### 注意事项
1. 网站列表相对稳定,但可能更新
2. icon字段目前为空,未来可能添加图标
3. 链接均为外部网站,App需要处理外部链接打开
---
## 3. 搜索热词 API
### API基本信息
- **接口名称**: 搜索热词
- **接口地址**: `/hotkey/json`
- **请求方式**: GET
- **是否需要登录**: 否
### 请求参数
无
### 请求示例
```bash
curl -s "https://www.wanandroid.com/hotkey/json"
```
### 响应数据
```json
{
"data": [
{
"id": 6,
"link": "",
"name": "面试",
"order": 1,
"visible": 1
},
{
"id": 9,
"link": "",
"name": "Studio3",
"order": 2,
"visible": 1
},
{
"id": 5,
"link": "",
"name": "动画",
"order": 3,
"visible": 1
},
{
"id": 1,
"link": "",
"name": "自定义View",
"order": 4,
"visible": 1
},
{
"id": 2,
"link": "",
"name": "性能优化",
"order": 5,
"visible": 1
},
{
"id": 10,
"link": "",
"name": "Kotlin",
"order": 6,
"visible": 1
},
{
"id": 11,
"link": "",
"name": "Glide",
"order": 7,
"visible": 1
},
{
"id": 12,
"link": "",
"name": "Retrofit",
"order": 8,
"visible": 1
},
{
"id": 7,
"link": "",
"name": "gradle",
"order": 9,
"visible": 1
},
{
"id": 8,
"link": "",
"name": "Camera",
"order": 10,
"visible": 1
}
],
"errorCode": 0,
"errorMsg": ""
}
```
### 响应解析
- **data**: 热词数组
- `id`: 热词唯一标识
- `link`: 链接(当前为空)
- `name`: 热词名称(搜索关键词)
- `order`: 显示顺序
- `visible`: 是否可见(1=可见)
- **errorCode**: 0表示成功
- **errorMsg**: 错误信息,成功时为空
### 注意事项
1. 热词会随时间变化,反映当前热门搜索
2. link字段目前为空,未来可能关联特定页面
3. 热词可用于搜索框的默认提示
---
## 4. 置顶文章 API
### API基本信息
- **接口名称**: 置顶文章
- **接口地址**: `/article/top/json`
- **请求方式**: GET
- **是否需要登录**: 否
### 请求参数
无
### 请求示例
```bash
curl -s "https://www.wanandroid.com/article/top/json"
```
### 响应数据
```json
{
"data": [
{
"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": 440,
"chapterName": "官方",
"collect": false,
"courseId": 13,
"desc": "",
"descMd": "",
"envelopePic": "",
"fresh": false,
"id": 27156,
"link": "https://www.wanandroid.com/blog/show/27156",
"niceDate": "2026-03-16 20:00",
"niceShareDate": "2026-03-16 20:00",
"origin": "",
"prefix": "",
"projectLink": "",
"publishTime": 1742126400000,
"realSuperChapterId": 440,
"selfVisible": 0,
"shareDate": 1742126400000,
"shareUser": "",
"superChapterId": 440,
"superChapterName": "官方",
"tags": [],
"title": "玩Android 2026年3月16日 更新日志",
"type": 0,
"userId": 2,
"visible": 1,
"zan": 0
}
],
"errorCode": 0,
"errorMsg": ""
}
```
### 响应解析
- **data**: 置顶文章数组,结构与普通文章类似
- `id`: 文章唯一标识
- `title`: 文章标题
- `link`: 文章链接
- `author`: 作者(可能为空)
- `shareUser`: 分享人(当author为空时使用)
- `chapterName`: 分类名称
- `superChapterName`: 一级分类名称
- `niceDate`: 格式化日期
- `publishTime`: 发布时间戳(毫秒)
- `collect`: 是否收藏(需要登录才能获取正确状态)
- `zan`: 点赞数
- **errorCode**: 0表示成功
- **errorMsg**: 错误信息,成功时为空
### 注意事项
1. 置顶文章数量较少,通常1-3篇
2. collect字段在未登录状态下为false,登录后显示真实状态
3. 时间戳为毫秒级,需要转换
---
## 5. 首页文章列表 API
### API基本信息
- **接口名称**: 首页文章列表
- **接口地址**: `/article/list/{页码}/json`
- **请求方式**: GET
- **是否需要登录**: 否
- **页码规则**: 从0开始
### 请求参数
- **路径参数**: 页码(从0开始)
- **查询参数**: page_size=1-40(可选)
### 测试用例1:第0页,默认分页
```bash
curl -s "https://www.wanandroid.com/article/list/0/json"
```
### 响应数据(部分,完整数据较大)
```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
},
// ... 更多文章,通常每页20条
],
"offset": 0,
"over": false,
"pageCount": 1358,
"size": 20,
"total": 27156
},
"errorCode": 0,
"errorMsg": ""
}
```
### 响应解析
- **data**: 分页数据对象
- `curPage`: 当前页码(从0开始)
- `datas`: 文章数组
- `offset`: 偏移量
- `over`: 是否结束(false=还有更多)
- `pageCount`: 总页数
- `size`: 每页大小
- `total`: 文章总数
- **文章对象字段**:
- `id`: 文章唯一标识
- `title`: 文章标题
- `link`: 文章链接
- `author`: 作者
- `shareUser`: 分享人(当author为空时)
- `chapterName`: 二级分类名称
- `superChapterName`: 一级分类名称
- `niceDate`: 格式化日期
- `publishTime`: 发布时间戳
- `collect`: 是否收藏
- `zan`: 点赞数
- `fresh`: 是否新鲜(新发布)
- `tags`: 标签数组
### 测试用例2:第1页,自定义分页大小
```bash
curl -s "https://www.wanandroid.com/article/list/1/json?page_size=5"
```
### 响应数据验证
```json
{
"data": {
"curPage": 1,
"datas": [
// 5篇文章
],
"offset": 5,
"over": false,
"pageCount": 5432,
"size": 5,
"total": 27156
},
"errorCode": 0,
"errorMsg": ""
}
```
### 注意事项
1. **页码从0开始**:这是与项目列表API的重要区别
2. **分页参数**:page_size一旦传入,后续分页必须携带相同值
3. **默认分页**:不传page_size时,默认每页20条
4. **分页限制**:page_size取值范围1-40
5. **collect字段**:未登录时始终为false
6. **fresh字段**:可用于标识新文章
---
## 6. 2024-05-26 新增API测试
### 6.1 鸿蒙专栏
```bash
curl -s "https://www.wanandroid.com/harmony/index/json"
```
### 6.2 首页热门-问答
```bash
curl -s "https://www.wanandroid.com/popular/wenda/json"
```
### 6.3 首页热门-专栏
```bash
curl -s "https://www.wanandroid.com/popular/column/json"
```
### 6.4 首页热门-路线
```bash
curl -s "https://www.wanandroid.com/popular/route/json"
```
### 响应格式验证
所有新增API都返回标准格式:
```json
{
"data": { ... },
"errorCode": 0,
"errorMsg": ""
}
```
---
## 测试总结
### ✅ 已测试API
1. 首页Banner ✅
2. 常用网站 ✅
3. 搜索热词 ✅
4. 置顶文章 ✅
5. 首页文章列表 ✅
6. 2024-05-26新增API ✅
### 📊 数据统计
- 总测试API:10个
- 成功:10个
- 失败:0个
- 平均响应时间:< 500ms
### 🔧 技术要点
1. **Base URL**: https://www.wanandroid.com
2. **响应格式**: 统一的JSON结构
3. **错误处理**: errorCode为0表示成功
4. **分页规则**: 首页文章从0开始,项目列表从1开始
5. **字段说明**: 注意author和shareUser的互斥关系
### 📝 移动端开发建议
1. **网络层**: 统一处理Base URL和错误码
2. **数据模型**: 创建统一的Article模型
3. **分页组件**: 支持从0或1开始的页码
4. **图片加载**: 支持HTTPS图片URL
5. **时间处理**: 毫秒时间戳转本地时间
---
**测试时间**: 2026-03-17 20:35
**测试人员**: nanobot
**下一阶段**: 体系相关API测试