胡杨河市网站建设_网站建设公司_交互流畅度_seo优化

概述

动态接口允许用户在运行时创建和修改API端点，而无需重新部署应用程序。这对于需要频繁更改API结构的应用程序特别有用。

通过动态接口，开发人员可以根据业务需求快速调整API，提升开发效率和响应速度。

功能特点

动态创建和修改API端点：用户可以在运行时添加、更新或删除API端点。

支持JSON数据格式：动态接口支持JSON数据交换格式。

配置说明

新增一个动态脚本

在管理后台导航到“接口管理”-“脚本管理”模块。

点击左侧文件树上方的菜单“+”按钮，新增一个动态脚本文件。

修改脚本名称和内容。

点击运行按钮，测试脚本是否正常。

保存脚本。

例如

using System;

using System.Threading.Tasks;

using Newtonsoft.Json;

using System;

using JESAI.Core.Aspects;

using JESAI.Platform.Domain.Admin.Repositories;

using Jesai.DynamicDataSource.Sqlsugar.DynamicDatasources;

public class Program

{

public string Handle(string param){

//查询数据库

var provider = ServiceLocator.Instance.GetService<IDbProvider>();

var db=provider.GetConnection("Test").Result;

var data=db.Ado.SqlQuery<dynamic>("select * from mlt_sys_dynamic_datasource");

// 创建包含多个匿名对象的数组

var tableData = new[]

{

new { Id = 1, TableName = "用户表", TableCode = "user", TableDesc = "用户信息表", IsValid = 1, CreateTime = "2023-10-01 12:00:00" },

new { Id = 2, TableName = "订单表", TableCode = "order", TableDesc = "订单信息表", IsValid = 1, CreateTime = "2023-10-02 12:00:00" },

new { Id = 3, TableName = "产品表", TableCode = "product", TableDesc = "产品信息表", IsValid = 0, CreateTime = "2023-10-03 12:00:00" }

};

var result=new {ErrorCode="000000",Message="操作成功!",CurrentPage=1,Total=3,Data=new {tableData=tableData,DBData=data}};

var str=JsonConvert.SerializeObject(result);

return str;

}

public static async Task Main()

{

var p= new Program();

var result=p.Handle(null);

Console.WriteLine(result);

}

}

注意：接口的入口方法必须是public string Handle(string param)，其中param是JSON格式的字符串，返回值也是JSON格式的字符串。可以自己修改为动态的方法名。

如图所示，新增一个动态脚本。

微信图片_2025-11-24_101504_700

运行测试，如图所示，输出结果正常。

微信图片_2025-11-24_103039_727

2. 通过动态脚本创建API端点

- 在管理后台导航到“接口管理”-“接口定义”模块。

- 点击“新增”按钮，新增一个接口定义。

- 填写接口名称、路径、方法、脚本名称等信息。

- 点击“保存”按钮，保存接口定义。

如图所示，打开接口定义模块。

微信图片_2025-11-24_104529_387

如图所示，新增一个接口定义。

微信图片_2025-11-24_105204_858

测试调用

打开swagger，查看一下调用接口。

微信图片_2025-11-24_105513_546

使用JWT认证调用接口

Postman测试调用接口，传入参数，查看返回结果。

微信图片_2025-11-24_111346_110

使用API密钥授权‌或‌签名认证授权‌调用接口

先从系统查询AppID和AppSecret。（直接从数据库查询，管理模块暂时还没做）

微信图片_2025-11-28_134918_788

计算签名Token，计算方法如下：

取当前系统时间戳，使用AppSecret对齐进行加密，得到Token。

例如：当前时间戳为1699424000000，AppSecret为TWM8uRwhTNzOCU7PDXAN47fewMMnF9GP，使用Aes加密，得到Token为：

+74ZCFZHXe3z0in4RomdqA==

long currentTimeStamp = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();

var token= AesEncryptor.Instance.Encrypt(currentTimeStamp.ToString(), "TWM8uRwhTNzOCU7PDXAN47fewMMnF9GP");

Console.WriteLine(token);

调用接口时，在请求头或者参数中添加AppKey和Token。

微信图片_2025-11-28_141235_180

微信图片_2025-11-28_141258_105

注意：

- 前端调用，一般使用JWT，通过${baseUrl}/api/v1/UniformPlatform/Get/TestDynamicApi?param=1 调用。需要在请求头中添加Authorization，值为Bearer

j

w

t

T

o

k

e

n

。

<

/

s

p

a

n

>

−

<

s

p

a

n

s

t

y

l

e

="

c

o

l

o

r

:

r

e

d

;

f

o

n

t

−

w

e

i

g

h

t

:

b

o

l

d

;

">

A

P

I

密

钥

授

权

或

签

名

认

证

授

权

调

用

，

通

过

{baseUrl}/api/v1/UniformApp/Get/TestDynamicApi?param=1 调用。需要在请求头中添加AppKey，Token。