# 数据中台系统 API 文档 (v1.0.0)

## 1. 接口概述

### 1.1 功能范围
- 数据血缘追踪
- 接口调用分析
- 数据质量监控

### 1.2 基础路径
`/api/v1/[系统名称]`

### 1.3 权限控制
- 公开接口（无需认证）：数据查询
- 管理接口（需要认证）：数据管理
- 系统接口（高级权限）：配置管理

### 1.4 全局错误码
| 状态码 | 说明               |
|--------|--------------------|
| 400    | 请求参数无效       |
| 401    | 未授权             |
| 403    | 权限不足           |
| 404    | 资源不存在         |
| 500    | 服务器内部错误     |
`/api/v1/data`

## 2. 接口明细

### 2.1 数据血缘查询
```
GET /lineage
```

**请求参数**:
| 参数        | 类型   | 必填 | 说明               |
|-------------|--------|------|--------------------|
| source      | string | 否   | 源表名            |
| target      | string | 否   | 目标表名          |

**响应示例**:
```json
{
  "status": "success",
  "data": {
    "lineage": [
      {
        "source": "table_a",
        "target": "table_b",
        "transform_type": "join"
      }
    ]
  }
}
```

### 2.2 接口审计
```
GET /audit-logs
```

**请求参数**:
| 参数        | 类型   | 必填 | 说明               |
|-------------|--------|------|--------------------|
| start_time  | string | 否   | 开始时间          |
| end_time    | string | 否   | 结束时间          |
| api_name    | string | 否   | 接口名称          |

**响应示例**:
```json
{
  "status": "success",
  "data": {
    "logs": [
      {
        "id": "log_001",
        "api_name": "/lineage",
        "request_time": "2024-01-20T10:00:00Z",
        "response_time": 150,
        "status": "success"
      }
    ],
    "total_count": 100
  }
}
```

## 3. 性能指标
- 血缘查询响应时间 < 500ms
- 审计日志保留至少180天
## 3. 版本历史

### v1.0.0 (2024-01-20)
- 新增: 按照API文档规范标准统一格式
- 优化: 统一响应格式和错误处理
- 功能: 完成基础接口定义