数安云智数据分类分级同步接口

这是一个用于批量处理字段信息分类分级的同步接口服务。

接口信息

• 接口地址: http://localhost:8080/api/llm_infer_zh_and_cls_and_type_v2_batchdata_sync
• 认证方式: Bearer Token
• Content-Type: application/json

环境变量配置

方式一：环境变量

# ~/.zshrc
export SHUYAN_API_KEY="your-api-key-here"
export SHUYAN_API_URL="http://localhost:8080"

方式二：OpenClaw配置

在 ~/.openclaw/openclaw.json 中配置：

{
  "skills": {
    "entries": {
      "shuyan-data-classification": {
        "enabled": true,
        "apiKey": "your-api-key-here",
        "apiUrl": "http://localhost:8080"
      }
    }
  }
}

使用场景

✅ USE this skill when:

• 需要对数据库字段进行敏感数据分类
• 需要识别数据敏感级别
• 需要批量处理数据分类分级
• 需要获取分类理由和置信度

❌ DON'T use this skill when:

• 单个字段的实时查询（效率较低）
• 历史数据分析

请求格式

请求参数说明

命令示例

批量分类分级同步

API_KEY="${SHUYAN_API_KEY:-your-api-key-here}"
API_URL="${SHUYAN_API_URL:-http://localhost:8080}"

curl -s -X POST "${API_URL}/api/llm_infer_zh_and_cls_and_type_v2_batchdata_sync" 
  -H "Authorization: Bearer ${API_KEY}" 
  -H "Content-Type: application/json" 
  -d '[
    {
      "colNameCh": "用户姓名",
      "colNameComment": "用户的真实姓名",
      "colNameEn": "user_name",
      "projectName": "用户管理系统",
      "sampleList": ["张三", "李四", "王五"],
      "sizeInBytes": 1024,
      "standardCode": "llm_infer_zh_and_cls_and_type_v2_test",
      "tableNameCh": "用户表",
      "tableNameEn": "user",
      "sensitivityLevelRedisKey": "fenji_standard",
      "dataSize": "10000",
      "isDesensitize": 0
    },
    {
      "colNameCh": "身份证号",
      "colNameComment": "用户的身份证号码",
      "colNameEn": "id_card",
      "projectName": "用户管理系统",
      "sampleList": ["110101199001011234"],
      "sizeInBytes": 2048,
      "standardCode": "llm_infer_zh_and_cls_and_type_v2_test",
      "tableNameCh": "用户表",
      "tableNameEn": "user",
      "sensitivityLevelRedisKey": "fenji_standard",
      "dataSize": "10000",
      "isDesensitize": 1
    }
  ]'

响应格式

成功响应

{
  "code": 200,
  "message": "Batch processing completed successfully",
  "result": [
    {
      "colNameCh": "用户姓名",
      "colNameComment": "用户的真实姓名",
      "colNameEn": "user_name",
      "confidence": 0,
      "itemName": "个人基本信息",
      "label": ["客户", "个人", "个人自然信息", "个人基本概况信息"],
      "projectName": "用户管理系统",
      "reasoningProcess": "字段含义为用户的真实姓名，属于个人基本情况数据",
      "standardCode": "llm_infer_zh_and_cls_and_type_v2_test",
      "tableNameCh": "用户表",
      "tableNameEn": "user",
      "sensitivityLevel": 2
    }
  ]
}

响应字段说明

结果项字段说明

敏感度等级说明

错误处理

常见错误：

常见使用示例

示例1：用户信息表分类

curl -s -X POST "http://localhost:8080/api/llm_infer_zh_and_cls_and_type_v2_batchdata_sync" 
  -H "Authorization: Bearer your-api-key-here" 
  -H "Content-Type: application/json" 
  -d '[
    {
      "colNameCh": "手机号",
      "colNameComment": "用户联系电话",
      "colNameEn": "phone",
      "projectName": "用户系统",
      "standardCode": "llm_infer_zh_and_cls_and_type_v2_test",
      "sensitivityLevelRedisKey": "fenji_standard"
    }
  ]'

示例2：金融数据分类

curl -s -X POST "http://localhost:8080/api/llm_infer_zh_and_cls_and_type_v2_batchdata_sync" 
  -H "Authorization: Bearer your-api-key-here" 
  -H "Content-Type: application/json" 
  -d '[
    {
      "colNameCh": "银行账号",
      "colNameComment": "银行账户号码",
      "colNameEn": "bank_account",
      "projectName": "金融系统",
      "standardCode": "llm_infer_zh_and_cls_and_type_v2_test",
      "sensitivityLevelRedisKey": "fenji_standard"
    },
    {
      "colNameCh": "交易金额",
      "colNameComment": "交易金额",
      "colNameEn": "amount",
      "projectName": "金融系统",
      "standardCode": "llm_infer_zh_and_cls_and_type_v2_test",
      "sensitivityLevelRedisKey": "fenji_standard"
    }
  ]'

注意事项

1. 接口为同步处理，处理时间可能较长
2. 建议批量处理时控制单次请求数量（建议不超过100条）
3. 接口会自动对失败的字段进行重试