AgileConfig - RESTful API 介绍

MJ.Zhou

发布于 2021-01-20 19:41:46

3280

发布于 2021-01-20 19:41:46

AgileConfig

AgileConfig是一个基于.net core开发的轻量级配置中心。

AgileConfig秉承轻量化的特点，部署简单、配置简单、使用简单、学习简单，它只提取了必要的一些功能，并没有像Apollo那样复杂且庞大。但是它的功能也已经足够你替换webconfig，appsettings.json这些文件了。如果你不想用微服务全家桶，不想为了部署一个配置中心而需要看N篇教程跟几台服务器那么你可以试试AgileConfig ：）

RESTful Api

为了更加方便的跟业务系统集成最新版的AgileConfig已支持json格式的 restful api来维护配置。

本API入参跟出参为json格式，所以请求的时候需设置Content-Type头部为application/json 。

使用basic简单认证，设置Authorization头部为Basic base64(userName:password) 。

当操作节点、应用api的时候basic认证的userName固定设置为admin，password为当前密码。

当操作配置api的时候basic认证的userName为应用的appid，password为应用的秘钥。

节点

因为本系统登录的时候没有用户名所以basic认证的时候用户名固定使用admin密码为当前设置的密码

model

    {
        "address": "http://localhost:5000",
        "remark": "this",
        "status": 0, // 1=online 0=offile
        "lastEchoTime": null
    }

获取所有节点

参数名	值
url	/api/node
method	GET
status code	200
response content	model

添加节点

参数名	值
url	/api/node
method	POST
status code	201
request body	model
response content	空

删除节点

参数名	值
url	/api/node?address={address}
method	DELETE
status code	204
response content	空

应用

因为本系统登录的时候没有用户名所以basic认证的时候用户名固定使用admin密码为当前设置的密码

model

   {
        "id": "xxx",
        "name": "测试程序3",
        "secret": "",
        "enabled": true, //是否启用
        "inheritanced": true, //是否可以继承
        "inheritancedApps": null //继承的app列表
    }

获取所有应用

参数名	值
url	/api/app
method	GET
status code	200
response content	model

获取单一应用

参数名	值
url	/api/app/{appid}
method	GET
status code	200
response content	model

添加应用

参数名	值
url	/api/app
method	POST
status code	201
request body	model
response content	空

修改应用

参数名	值
url	/api/app
method	PUT
status code	200
request body	model
response content	空

配置

配置的basic认证用户名使用appId密码使用secret

model

    {
        "id": "0986e7ed33c447618f28e92360394cea",
        "appId": "xxx",
        "group": "", //组
        "key": "key1", 
        "value": "3333",
        "description": null, //描述
        "onlineStatus": 0, //是否在线 0=等待上线 1=在线
        "status": 1 // 0=删除 1=正常
    }

获取所有app的配置

参数名	值
url	/api/config
method	GET
status code	200
response content	model

获取单一配置

参数名	值
url	/api/config/{id}
method	GET
status code	200
response content	model

新建配置

参数名	值
url	/api/config
method	POST
status code	201
request body	model
response content	空

修改配置

参数名	值
url	/api/config
method	PUT
status code	200
request body	model
response content	空

删除配置

参数名	值
url	/api/config/{id}
method	DELETE
status code	204
response content	空

上线配置

参数名	值
url	/api/config/publish/{id}
method	POST
status code	200
response content	空

下线配置

参数名	值
url	/api/config/offline/{id}
method	POST
status code	200
response content	空