简介 #
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"
}
}