Api Spider Tag
目录
分类管理接口文档
接口列表
| 接口名称 | 方法 | 路径 | 说明 |
|---|---|---|---|
| 添加分类 | POST | /Spider/Tag/addtag | 添加新分类 |
| 编辑分类 | POST | /Spider/Tag/edittag | 编辑分类信息 |
| 分类列表 | POST | /Spider/Tag/taglist | 获取分类列表 |
| 删除分类 | POST | /Spider/Tag/deltag | 删除分类(软删除) |
1. 添加分类
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appid | int | 否 | 应用ID,默认1 |
| pid | int | 否 | 模块ID,默认1 |
| uid | string | 是 | 用户id |
| token | string | 是 | 用户登录token |
| json | int | 否 | 输入格式,默认1 |
| tag_name | string | 是 | 分类名称 |
| outputformat | int | 否 | 输出格式,默认2 |
请求示例
{
"uid": "Mbz9Q1O0O0Ob",
"token": "928CC0AD9C0D38E56F877A647C7F2CDE",
"json": 1,
"outputformat": 2,
"pid": "156",
"appid": 1,
"tag_name": "测试2"
}返回示例
{
"error": {
"code": 0,
"msg": "成功"
},
"data": 7
}返回码
| 返回码 | 说明 |
|---|---|
| 0 | 添加成功 |
| 70008 | 参数错误(分类名称为空) |
| 80015 | 分类名称已存在 |
| 80001 | 添加失败 |
2. 编辑分类
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appid | int | 否 | 应用ID,默认1 |
| pid | int | 否 | 模块ID,默认1 |
| uid | string | 是 | 用户id |
| token | string | 是 | 用户登录token |
| json | int | 否 | 输入格式,默认1 |
| id | int | 是 | 分类ID |
| appid | int | 否 | 应用ID,默认1 |
| tag_name | string | 是 | 分类名称 |
| outputformat | int | 否 | 输出格式,默认2 |
请求示例
{
"uid": "Mbz9Q1O0O0Ob",
"token": "928CC0AD9C0D38E56F877A647C7F2CDE",
"json": 1,
"outputformat": 2,
"pid": "156",
"appid": 1,
"id": 8,
"tag_name": "测试2"
}返回示例
{
"error": {
"code": 0,
"msg": "成功"
},
"data": 1
}返回码
| 返回码 | 说明 |
|---|---|
| 0 | 编辑成功 |
| 70008 | 参数错误(ID或分类名称为空) |
| 20018 | 分类不存在 |
| 80015 | 分类名称已存在 |
| 80001 | 编辑失败 |
3. 分类列表
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appid | int | 否 | 应用ID,默认1 |
| pid | int | 否 | 模块ID,默认1 |
| uid | string | 是 | 用户id |
| token | string | 是 | 用户登录token |
| json | int | 否 | 输入格式,默认1 |
| appid | int | 否 | 应用ID,默认1 |
| outputformat | int | 否 | 输出格式,默认2 |
请求示例
{
"uid": "Mbz9Q1O0O0Ob",
"token": "928CC0AD9C0D38E56F877A647C7F2CDE",
"json": 1,
"outputformat": 2,
"pid": "156",
"appid": 1
}返回示例
{
"error": {
"code": 0,
"msg": "成功"
},
"data": [
{
"id": 7,
"app_id": 1,
"create_time": 1781252875,
"update_time": 1781252875,
"is_del": 0,
"tag_name": "测试2"
},
{
"id": 6,
"app_id": 1,
"create_time": 1781252744,
"update_time": 1781253032,
"is_del": 0,
"tag_name": "测试222"
},
{
"id": 5,
"app_id": 1,
"create_time": 1781252613,
"update_time": 1781252613,
"is_del": 0,
"tag_name": "测试"
},
{
"id": 4,
"app_id": 1,
"create_time": null,
"update_time": null,
"is_del": 0,
"tag_name": "创新"
},
{
"id": 3,
"app_id": 1,
"create_time": null,
"update_time": null,
"is_del": 0,
"tag_name": "热点"
},
{
"id": 2,
"app_id": 1,
"create_time": null,
"update_time": null,
"is_del": 0,
"tag_name": "事件"
},
{
"id": 1,
"app_id": 1,
"create_time": null,
"update_time": null,
"is_del": 0,
"tag_name": "人物"
}
]
}返回码
| 返回码 | 说明 |
|---|---|
| 0 | 获取成功 |
| 20018 | 暂无数据 |
4. 删除分类
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appid | int | 否 | 应用ID,默认1 |
| pid | int | 否 | 模块ID,默认1 |
| uid | string | 是 | 用户id |
| token | string | 是 | 用户登录token |
| json | int | 否 | 输入格式,默认1 |
| id | int | 是 | 分类ID |
| outputformat | int | 否 | 输出格式,默认2 |
请求示例
{
"uid": "Mbz9Q1O0O0Ob",
"token": "928CC0AD9C0D38E56F877A647C7F2CDE",
"json": 1,
"outputformat": 2,
"pid": "156",
"id": 13
}返回示例
{
"error": {
"code": 0,
"msg": "成功"
},
"data": 1
}返回码
| 返回码 | 说明 |
|---|---|
| 0 | 删除成功 |
| 70008 | 参数错误 |
| 20018 | 分类不存在 |
| 80005 | 分类被文章引用,无法删除 |
| 80003 | 删除失败 |
删除限制说明
- 如果分类被文章引用(
spider_tag_id字段关联),则无法删除 - 只有未被任何文章引用的分类才能被删除
通用返回码说明
| 返回码 | 说明 |
|---|---|
| 0 | 成功 |
| 70008 | 参数错误 |
| 20018 | 数据不存在 |
| 80001 | 操作失败 |
| 80003 | 更新/删除失败 |
| 80005 | 数据被引用,无法删除 |
| 80015 | 数据已存在 |