目录

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