目录

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 数据已存在