a
This commit is contained in:
@@ -0,0 +1,54 @@
|
||||
# 体系数据 API
|
||||
|
||||
## 基本信息
|
||||
- **接口名称**: 体系数据
|
||||
- **接口地址**: `/tree/json`
|
||||
- **请求方式**: GET
|
||||
- **是否需要登录**: 否
|
||||
- **Base URL**: https://www.wanandroid.com
|
||||
|
||||
## 请求参数
|
||||
|
||||
|
||||
## 请求示例
|
||||
|
||||
### cURL
|
||||
```bash
|
||||
curl -X GET "https://www.wanandroid.com/tree/json" \
|
||||
-H "Accept: application/json"
|
||||
```
|
||||
|
||||
## 响应数据
|
||||
|
||||
### 响应格式
|
||||
```json
|
||||
{
|
||||
"data": { ... },
|
||||
"errorCode": 0,
|
||||
"errorMsg": ""
|
||||
}
|
||||
```
|
||||
|
||||
### 响应字段说明
|
||||
|
||||
#### 根对象
|
||||
| 字段名 | 类型 | 说明 |
|
||||
|--------|------|------|
|
||||
| data | object/array | 业务数据 |
|
||||
| errorCode | integer | 错误码:0=成功,-1=普通错误,-1001=登录失效 |
|
||||
| errorMsg | string | 错误信息,成功时为空 |
|
||||
|
||||
## 注意事项
|
||||
|
||||
|
||||
## 测试状态
|
||||
|
||||
- **测试时间**: 2026-03-17
|
||||
- **测试状态**: ✅ 已验证(通过实际请求测试)
|
||||
- **测试人员**: nanobot
|
||||
|
||||
---
|
||||
|
||||
**文档版本**: 1.0
|
||||
**最后更新**: 2026-03-17
|
||||
**API分类**: 体系
|
||||
@@ -0,0 +1,70 @@
|
||||
# 体系下的文章 API
|
||||
|
||||
## 基本信息
|
||||
- **接口名称**: 体系下的文章
|
||||
- **接口地址**: `/article/list/{页码}/json`
|
||||
- **请求方式**: GET
|
||||
- **是否需要登录**: 否
|
||||
- **Base URL**: https://www.wanandroid.com
|
||||
|
||||
## 请求参数
|
||||
|
||||
### 路径参数
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|
||||
|--------|------|------|------|------|
|
||||
| 页码 | integer | 是 | 页码,从0开始 | 0 |
|
||||
|
||||
### 查询参数
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|
||||
|--------|------|------|------|------|
|
||||
| cid | integer | 是 | 分类ID | 60 |
|
||||
|
||||
### 通用查询参数
|
||||
| 参数名 | 类型 | 必填 | 说明 | 取值范围 | 示例 |
|
||||
|--------|------|------|------|----------|------|
|
||||
| page_size | integer | 否 | 每页条数 | 1-40 | 20 |
|
||||
|
||||
## 请求示例
|
||||
|
||||
### cURL
|
||||
```bash
|
||||
curl -X GET "https://www.wanandroid.com/article/list/0/json?cid=60" \
|
||||
-H "Accept: application/json"
|
||||
```
|
||||
|
||||
## 响应数据
|
||||
|
||||
### 响应格式
|
||||
```json
|
||||
{
|
||||
"data": { ... },
|
||||
"errorCode": 0,
|
||||
"errorMsg": ""
|
||||
}
|
||||
```
|
||||
|
||||
### 响应字段说明
|
||||
|
||||
#### 根对象
|
||||
| 字段名 | 类型 | 说明 |
|
||||
|--------|------|------|
|
||||
| data | object/array | 业务数据 |
|
||||
| errorCode | integer | 错误码:0=成功,-1=普通错误,-1001=登录失效 |
|
||||
| errorMsg | string | 错误信息,成功时为空 |
|
||||
|
||||
## 注意事项
|
||||
|
||||
2. **分页规则**: 页码从0开始
|
||||
3. **分页参数**: page_size一旦传入,后续分页必须携带相同值
|
||||
|
||||
## 测试状态
|
||||
|
||||
- **测试时间**: 2026-03-17
|
||||
- **测试状态**: ✅ 已验证(通过实际请求测试)
|
||||
- **测试人员**: nanobot
|
||||
|
||||
---
|
||||
|
||||
**文档版本**: 1.0
|
||||
**最后更新**: 2026-03-17
|
||||
**API分类**: 体系
|
||||
@@ -0,0 +1,70 @@
|
||||
# 按作者搜文章 API
|
||||
|
||||
## 基本信息
|
||||
- **接口名称**: 按作者搜文章
|
||||
- **接口地址**: `/article/list/{页码}/json`
|
||||
- **请求方式**: GET
|
||||
- **是否需要登录**: 否
|
||||
- **Base URL**: https://www.wanandroid.com
|
||||
|
||||
## 请求参数
|
||||
|
||||
### 路径参数
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|
||||
|--------|------|------|------|------|
|
||||
| 页码 | integer | 是 | 页码,从0开始 | 0 |
|
||||
|
||||
### 查询参数
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|
||||
|--------|------|------|------|------|
|
||||
| author | string | 是 | 作者昵称(精确匹配) | 鸿洋 |
|
||||
|
||||
### 通用查询参数
|
||||
| 参数名 | 类型 | 必填 | 说明 | 取值范围 | 示例 |
|
||||
|--------|------|------|------|----------|------|
|
||||
| page_size | integer | 否 | 每页条数 | 1-40 | 20 |
|
||||
|
||||
## 请求示例
|
||||
|
||||
### cURL
|
||||
```bash
|
||||
curl -X GET "https://www.wanandroid.com/article/list/0/json?author=鸿洋" \
|
||||
-H "Accept: application/json"
|
||||
```
|
||||
|
||||
## 响应数据
|
||||
|
||||
### 响应格式
|
||||
```json
|
||||
{
|
||||
"data": { ... },
|
||||
"errorCode": 0,
|
||||
"errorMsg": ""
|
||||
}
|
||||
```
|
||||
|
||||
### 响应字段说明
|
||||
|
||||
#### 根对象
|
||||
| 字段名 | 类型 | 说明 |
|
||||
|--------|------|------|
|
||||
| data | object/array | 业务数据 |
|
||||
| errorCode | integer | 错误码:0=成功,-1=普通错误,-1001=登录失效 |
|
||||
| errorMsg | string | 错误信息,成功时为空 |
|
||||
|
||||
## 注意事项
|
||||
|
||||
2. **分页规则**: 页码从0开始
|
||||
3. **分页参数**: page_size一旦传入,后续分页必须携带相同值
|
||||
|
||||
## 测试状态
|
||||
|
||||
- **测试时间**: 2026-03-17
|
||||
- **测试状态**: ✅ 已验证(通过实际请求测试)
|
||||
- **测试人员**: nanobot
|
||||
|
||||
---
|
||||
|
||||
**文档版本**: 1.0
|
||||
**最后更新**: 2026-03-17
|
||||
**API分类**: 体系
|
||||
Reference in New Issue
Block a user