# 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 |

### 请求示例

```json
{
    "uid": "Mbz9Q1O0O0Ob",
    "token": "928CC0AD9C0D38E56F877A647C7F2CDE",
    "json": 1,
	"outputformat": 2,
    "pid": "156",
    "appid": 1,
    "tag_name": "测试2"
}
```

### 返回示例

```json
{
    "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 |

### 请求示例

```json
{
    "uid": "Mbz9Q1O0O0Ob",
    "token": "928CC0AD9C0D38E56F877A647C7F2CDE",
    "json": 1,
	"outputformat": 2,
    "pid": "156",
    "appid": 1,
	"id": 8,
    "tag_name": "测试2"
}
```

### 返回示例

```json
{
    "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 |

### 请求示例

```json
{
    "uid": "Mbz9Q1O0O0Ob",
    "token": "928CC0AD9C0D38E56F877A647C7F2CDE",
    "json": 1,
	"outputformat": 2,
    "pid": "156",
    "appid": 1
}
```

### 返回示例

```json
{
    "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 |

### 请求示例

```json
{
    "uid": "Mbz9Q1O0O0Ob",
    "token": "928CC0AD9C0D38E56F877A647C7F2CDE",
    "json": 1,
	"outputformat": 2,
    "pid": "156",
    "id": 13
}
```

### 返回示例

```json
{
    "error": {
        "code": 0,
        "msg": "成功"
    },
    "data": 1
}
```

### 返回码

| 返回码 | 说明 |
|--------|------|
| 0 | 删除成功 |
| 70008 | 参数错误 |
| 20018 | 分类不存在 |
| 80005 | 分类被文章引用，无法删除 |
| 80003 | 删除失败 |

### 删除限制说明

- 如果分类被文章引用（`spider_tag_id` 字段关联），则无法删除
- 只有未被任何文章引用的分类才能被删除

---

## 通用返回码说明

| 返回码 | 说明 |
|--------|------|
| 0 | 成功 |
| 70008 | 参数错误 |
| 20018 | 数据不存在 |
| 80001 | 操作失败 |
| 80003 | 更新/删除失败 |
| 80005 | 数据被引用，无法删除 |
| 80015 | 数据已存在 |