跳到主要内容

api数据集

1.新增数据集

  • 点击“数据集管理”或者“数据”中数据集后的均可打开数据集管理界面

  • 点击“新增分组”可添加分组信息;点击“新增数据集”可添加数据集信息

2.新增分组

输入分组名称,添加即可

3.新增数据源

数据集名称:可随意输入

分组:选择分组信息

数据类型:选择“API”

API接口:输入接口后 点击“api解析”,会将api返回字段解析出来

列表字段:解析的字段

参数字段:sql或api所带参数

3.1参数

  1. API接口:输入接口后 点击“api解析”,会将api路径设置的参数解析出来

2.配置api: https://api.jeecg.com/mock/51/commerceSalesOperations?type=${type}

  • 参数:动态解析参数使用${}

3.手动设置参数: 对于特殊场景,可以手动添加参数字段和默认值

4.支持GET和POST请求

  • 支持GET和POST请求方式,默认是GET请求
  • 如果是POST请求,需要在API接口中采用URL方式传递请求体参数,你需要把参数以 query string 形式拼接到 url,后端会解析出来放到 body。

下面是一个 POST 接口文档的举例,参数通过 URL 拼接,后端自动转为 body 的 JSON:

  • 接口地址:/api/user/create
  • 请求方式:POST
  • 请求头:Content-Type: application/json
  • 参数传递:参数拼接在 URL 上,后端自动转为 JSON 放到 body

请求示例:

POST /api/user/create?name=张三&age=18
Authorization: Bearer {token}

最终 body 内容:

{
"name": "张三",
"age": 18
}

5.列表字段说明

  • 字段名:字段名称
  • 字段文本:字段文本,可修改
  • 字段类型:字符、日期、数值
  • 控件类型:文本、图片
  • 是否显示:设置是否显示该字段
  • 是否总计:统计合计

6.API数据返回JSON格式

[  
  {
    "name": "1月",
    "value": 200
  },
  {
    "name": "2月",
    "value": 100
  },
  {
    "name": "3月",
    "value": 100
  },
  {
    "name": "4月",
    "value": 100
  },
  {
    "name": "5月",
    "value": 50
  },
  {
    "name": "6月",
    "value": 120
  }
]