675 lines
15 KiB
Markdown
675 lines
15 KiB
Markdown
# 玩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测试 |