chengshishouce/AI_AUDIT_API.md

AI 审核 API 文档

概述

AI 审核模块提供自动内容审核功能，支持文章、评论、特色服务的自动审核。

功能特性

• ✅ 敏感词检测
• ✅ 广告内容检测
• ✅ 内容质量评估
• ✅ 自动审核决策

API 端点

1. 审核文章

端点: POST /api/audit/article/

认证: 需要 JWT Token

请求体:

{
  "title": "文章标题",
  "content": "文章内容"
}

响应:

{
  "approved": true,
  "reason": "审核通过",
  "details": {
    "quality_score": 100
  }
}

拒绝示例:

{
  "approved": false,
  "reason": "内容包含敏感词：暴力",
  "details": {
    "sensitive_words": ["暴力"]
  }
}

---

2. 审核评论

端点: POST /api/audit/comment/

认证: 需要 JWT Token

请求体:

{
  "content": "评论内容"
}

响应:

{
  "approved": true,
  "reason": "审核通过"
}

---

3. 审核特色服务

端点: POST /api/audit/service/

认证: 需要 JWT Token

请求体:

{
  "name": "服务名称",
  "description": "服务描述"
}

响应:

{
  "approved": true,
  "reason": "审核通过"
}

---

4. 审核服务状态

端点: GET /api/audit/status/

认证: 需要 JWT Token

响应:

{
  "status": "active",
  "service": "AI Audit Service",
  "version": "1.0.0",
  "features": [
    "敏感词检测",
    "广告检测",
    "内容质量评估"
  ]
}

---

测试用例

测试	输入	预期结果	状态
文章审核 (正常)	北京旅游攻略	✅ 通过	✅
文章审核 (敏感词)	包含暴力内容	❌ 拒绝	✅
评论审核 (广告)	加微信 123456	❌ 拒绝	✅
服务审核 (正常)	老北京烤鸭店	✅ 通过	✅
内容质量 (太短)	好	❌ 拒绝	✅

---

敏感词库

当前敏感词库包含：

• 暴力、恐怖、色情、赌博、毒品
• 诈骗、传销、假币、枪支、弹药

广告关键词

• 加微信、QQ 群、联系电话、手机号
• www.、.com、.cn、http

内容质量规则

• 最小长度：10 个字符
• 重复字符检测
• 中文内容比例检查

---

集成示例

Python 示例

import requests

TOKEN = 'your_jwt_token'
HEADERS = {
    'Authorization': f'Bearer {TOKEN}',
    'Content-Type': 'application/json'
}

# 审核文章
response = requests.post(
    'http://cssc.datalibstar.com/api/audit/article/',
    headers=HEADERS,
    json={
        'title': '北京旅游攻略',
        'content': '北京是中国的首都...'
    }
)
result = response.json()
print(result['approved'])  # True/False

JavaScript 示例

const TOKEN = 'your_jwt_token';

// 审核文章
fetch('http://cssc.datalibstar.com/api/audit/article/', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${TOKEN}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    title: '北京旅游攻略',
    content: '北京是中国的首都...'
  })
})
.then(res => res.json())
.then(data => {
  console.log(data.approved);  // True/False
});

---

部署状态

• ✅ 本地开发环境
• ✅ 云服务器 (cssc.datalibstar.com)
• ✅ 所有测试用例通过