EasyData API 接口文档

版本 v1.0

更新日期：2026-04-15

🌐 1. 概述

EasyData 是一个由 7 个子系统组成的综合性数据管理平台生态系统，采用前后端分离架构。

应用中心

端口：30000

应用平台与统一认证

接口服务中心

端口：27000

API 接口管理与动态路由

数据质量中心

端口：28000

数据质量检查与治理

任务计划中心

端口：29000

计划任务调度与通知

数据操作台

端口：31000

数据操作台与 SQL 编辑器

工作流平台

端口：33000

工作流编排与执行平台

AI 智能体

端口：32000

AI 智能对话与 MCP 集成

🔐 2. 认证机制

2.1 认证方式

方式	请求头	适用场景
JWT Token	`Authorization: <token>`	用户登录后获取 Token
AccessKey	`EasyData-Access-Key: ez_xxx`	免登录访问（推荐）
API Access Key	`EasyAPI-Access-Key: xxx`	访问授权的特定接口

2.2 登录接口

POST/api/auth/login
Content-Type: application/json

{
  "username": "admin",
  "password": "password123"
}

✅ 响应示例

{
  "success": true,
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "user": {
      "id": 1,
      "username": "admin",
      "role": "admin"
    }
  }
}

2.3 标准响应格式

成功响应

{
  "success": true,
  "data": { ... }
}

列表响应

{
  "success": true,
  "data": [],
  "total": 100
}

错误响应

{
  "success": false,
  "message": "错误描述"
}