# Easy-API

**Repository Path**: APIJSON/api-easy

## Basic Information

- **Project Name**: Easy-API
- **Description**: 基于APIJSON的低代码开发平台。本仓库为副本，请给原仓库右上角点亮 ⭐️ Star
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: develop
- **Homepage**: https://gitee.com/HackOwnLife485/api-easy
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-08-20
- **Last Updated**: 2025-08-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 基于APIJSON的低代码开发平台

## 介绍
基于APIJSON的低代码开发平台，具有以下特点：
1. 统一的接口抽象层（适配器）
2. 强大的数据转换能力
3. 可视化的配置界面
4. 完善的日志与异常处理机制

## 软件架构
```text
+---------------------+
|  前端：低代码配置台 |
| （Vue/React + JSON Schema）|
+----------+----------+
           |
           v
+----------------------+
| 后端服务层            |
| - APIJSON ORM         |
| - 动态接口解析        |
| - 数据转换引擎        |
| - 日志/权限控制       |
+----------+-----------+
           |
           v
+-----------------------+
| ERP 对接适配器层      |
| - SAP Adapter         |
| - Yonyou Adapter      |
| - Kingdee Adapter     |
| - 自定义 Adapter      |
+----------+------------+
           |
           v
+-----------------------+
| ERP 外部系统接口       |
| - RESTful / SOAP / OData |
| - 数据库直连（可选）   |
+-----------------------+
```

## 核心模块设计
### 低代码配置前端（Low-code UI）
#### 功能： 
- 接口管理页面（增删改查） 
- 接口字段映射编辑器
- 条件筛选、参数设置、定时任务配置
- 接口调用测试工具
#### 技术栈：
- Vue2 + JavaScript
- Element UI
- JSON Schema

### APIJSON 核心服务
#### 功能：
- 接口配置中心
  - 存储 ERP 接口元数据（URL、方法、Header、Body 结构）
  - 存储字段映射关系（ERP 字段 <-> 内部系统字段）
- 动态请求代理
  - 支持 RESTful/SOAP/OData 协议
  - 动态构造请求体（JSON/XML）
  - 支持 Token、OAuth2、Basic Auth 认证
- 数据转换引擎
  - 使用 JSONPath/XPath 进行字段提取
  - 支持字段映射、类型转换、默认值设置
  - 支持脚本扩展（Groovy / JavaScript）
- 日志与监控
  - 请求响应日志记录
  - 错误重试机制
  - 接口调用统计看板
- ERP 适配器模块（Adapter Layer）
  - 为不同 ERP 系统提供统一的接口封装
  - 封装底层协议差异（REST vs OData vs RFC）
  - 提供标准接口用于数据获取与写入
#### 技术栈：
- Spring Boot
- APIJSON 框架（支持动态 SQL 构建、ORM 映射）
- MyBatis Plus
- MySQL 存储配置信息

## 安装教程
1.  待定

## 使用说明
1. 用户在前端选择 ERP 类型（如 SAP）
2. 配置接口 URL、认证方式、请求参数模板
3. 拖拽字段映射关系（源字段 → 目标字段）
4. 设置定时任务或触发条件（如订单创建时触发）
5. 发布接口，系统自动生成 APIJSON 接口逻辑
6. 调用接口并查看执行结果和日志


## 扩展方向
- 支持接口编排（多个 ERP 接口串联）
- 支持流程引擎（如 Camunda）做业务流程自动化
- 支持 AI 辅助字段映射（NLP 分析字段含义）
- 支持接口性能优化（缓存、分页、批量处理）

## 参与贡献
1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request