数据中台-表数据导入接口 API 文档

接口基本信息

项目	销售子系统
接口名称	表数据导入接口
请求地址	`https://datafocus-test.dasaiot.com/datafocus/api/v1.0/table/import`
请求方法	POST（HTTP REST形式）
接口描述	向数据中台指定表导入业务数据
签名要求	是（基于 HMAC-SHA256 算法）

请求参数

请求头

参数名	必选	类型	描述	示例值
Secret-Id	是	String	接口鉴权密钥 ID（从系统管理 - 接口鉴权获取）	b367e56d2c0e4a03bf5a98c00c2e03c6
Tenant-Id	是	String	租户 ID（固定值）	10001
Content-Type	是	String	请求体格式	application/json

URL 查询参数（Query Parameters）

参数名	必选	类型	描述	生成规则
timestamp	是	String	毫秒级时间戳（防二次请求）	当前时间毫秒数（如 1723761234567）
nonce	是	String	16 位 16 进制随机字符串（防重放）	由 0-9、a-f 组成的 16 位字符串（如 a3f2d7c8b1e0965）
sign	是	String	签名串（防参数篡改）	通过 HMAC-SHA256 算法生成（详见「签名规则」章节）

请求体（Body）

请求体为 JSON 格式，包含目标表名、字段定义和数据行，示例如下：

  "tableName": "荷-用户分类统计",
  "columns": [
    {"columnName": "data_name", "dataType": "string"},
    {"columnName": "value", "dataType": "double"},
    {"columnName": "unit", "dataType": "string"},
    {"columnName": "measure_point", "dataType": "string"},
    {"columnName": "id", "dataType": "string"},
    {"columnName": "updateTime", "dataType": "timestamp"}
  ],
  "rows": [
    [
      "居民用户数",
      321,
      "户",
      "33333333/22222222",
      "1023/3204",
      "2025-08-15 00:00:00"
    ]
  ]
}

一级参数	必选	类型	描述	子参数说明
tableName	是	String	目标表名	-
columns	是	Array	字段定义列表（顺序需与 rows 一致）	`columnName`：字段名；`dataType`：字段类型
rows	是	Array	数据行列表	数组元素为数据值，顺序与 columns 定义的字段一一对应

📌

由于数据维度不统一，本接口对应着6张不同表结构的数据库表，因此在body中的columns参数的结构有6种，详细内容请参考：销售子系统接口API-body中的columns参数结构

签名规则

1. 签名原文拼接

生成签名原文 plainText，格式为：
plainText = 大写请求方法 + 请求路径 + 请求体 + nonce + Secret-Id + timestamp

大写请求方法：POST（固定）

请求路径：/datafocus/api/v1.0/table/import（固定）

请求体：JSON 字符串（请求体 raw 内容）

nonce：URL 参数中的 nonce 值

Secret-Id：请求头中的 Secret-Id 值

timestamp：URL 参数中的 timestamp 值

2. 加密算法

使用 HMAC-SHA256 算法对 plainText 进行加密，密钥为Secret-Key，加密结果转为 Hex 字符串（小写），即为 sign 值。

响应示例

Content-Type: application/json;charset=UTF-8
Content-Length: 1000
{
    "errCode": 0,
    "exception": "",
    "promptMsg": {},
    "success": true,
    "data": {
    "tableName": "荷-用户分类统计",
    "rowCount": 1
    }
}

参数说明：

data：返回tableName表名

销售子系统API文档

数据中台-表数据导入接口 API 文档#

接口基本信息#

请求参数#

请求头#

URL 查询参数（Query Parameters）#

请求体（Body）#

签名规则#

1. 签名原文拼接#

2. 加密算法#

响应示例#