推送数据源
创建
步骤1:点击创建数据源,选择“创建推送数据源”。
步骤2:在“创建推送数据源”页面中填写以下信息:
秘钥:为了验证身份,平台会给每个租户生成一个密钥,在调用接口时,需要使用这个密钥
名称:自定义数据源名称;
描述:可以对创建的数据源进行描述。
步骤3:根据需求维护,选择新增出参。
填入参数名称、描述和参数值,选择类型(NUMBER/DATE/STRING),然后点击“保存”。
步骤4:填写完成后,点击“确定”,完成推送数据源的添加。
查看详情
在数据源主页,点击数据源名称,查看数据详情。
点击API数据详情页面右上角的“ ”,可以选择“删除/编辑/查看/更多详情”。
删除
删除:可以删除当前推送数据源。
编辑
编辑:可以对当前数据进行编辑,修改配置。具体步骤同“创建推送数据源”。
接口规范
限制说明:
1.只接收JSON格式数据,若有嵌套结构创建数据时请选择对应的结构转换规则转换成单层结构;
2.单次请求数据量不得超出1M;
3.每日有最大请求次数;
4.1秒内同一IP请求频次不超过5次;
URL:
http://cloud-data-visualization.rootcloud.com/bi/api/datasource/push/pushData
支持格式:
JSON
HTTP请求方式:
POST
请求参数:
{
"key":"7689AE2EE5B1B18879BEE7013949D0F9C074AE5A83711937E29986",
"data":"[{'key':'value'}]",
"dsUuid":"1760234421961000024096"
}
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
key | string | 是 | 认证密钥 |
dsUuid | string | 是 | 数据源唯一标识:来源编辑数据源时地址上的dsUuid值 |
data | string | 是 | 请求数据:JSON格式字符串 数据中的字段名必须和声明的数据源响应字段名一致 |
返回字段:
{
"msg": "SUCCESS",
"ret": "",
"code": 0
}
字段 | 类型 | 说明 |
---|---|---|
msg | string | 消息内容 |
code | int | 错误码 |
ret | string | 数据内容 |
错误码说明:
code | msg |
---|---|
0 | SUCCESS |
10018 | 数据格式错误 |
200000010 | 数据超出1M限制 |
20000003 | 数据源id不存在 |
20000006 | authKey无效 |
20000009 | 推送次数超出限制 |
20000005 | 无权限推送此数据源 |
10022 | 该类型可创建的数据源个数已达上限 |
20000004 | 字段个数不匹配 如:字段个数不匹配 ["systemId","time","cut"]->["cc","systemId","cut","time"] 绿色:代表设置的数据源字段 红色:推送数据的字段 |
20000007 | 字段不存在 如:["cut"]字段不存在 (数据源中设置了cut字段 推送数据中未有此字段) |