Api数据集

简介 #

API 数据集允许 SmartChart 直接向外部 HTTP 接口发起请求,获取 JSON 格式的数据作为数据集内容。通过在数据集编辑器中编写 dataset = {...} 对象来描述请求方式、URL 和参数,支持 GET/POST 以及参数联动传递。


API接口要求 #

接口返回一定要是JSON格式

数据源配置方法 #

你可选择任意数据连接

使用方法 #

以下是简单的get及post方法样列

//GET 方法:
dataset= {
"url":"https://www.smartchart.cn/smartdata/api/?i=loaddataset1&j=1"
}

//POST 方法:
dataset= {
"url":"https://www.smartchart.cn/smartdata/api",
"method":"POST",
"data":{"i":"loaddataset1", "j":"1"}
 ...
}

可以传入参数做出联动效果

dataset= {
"url":"https://www.smartchart.cn/smartdata/api",
"method":"POST",
"data":{"i":"loaddataset1", "j":"/*$参数名*/"}
...
}

可以增加header等认证方式

dataset= {
"url":"https://www.smartchart.cn/smartdata/api",
"method":"GET",
"headers":{"Cookie":"xxxxxxx"}
...
}

API 数据集完整配置字段 #

字段 必填 说明
url 接口地址
method GET(默认)或 POST
data POST 请求体,字典格式
headers 请求头,如 Cookie、Authorization 等
/*$参数名*/ 在 data 或 url 中嵌入联动参数,参数不传时整段被忽略

完整示例:带参数联动的 POST 请求

dataset = {
  "url": "https://api.example.com/data",
  "method": "POST",
  "data": {
    "type": "sales",
    "region": "/*$region*/"
  },
  "headers": {
    "Authorization": "Bearer your_token"
  }
}