文档中心

数据智能体 DataAgent（私有化）

文件转文档

读取表格表头

读取表格表头

调用本接口读取上传的表格文件的表头信息，用于后续数据映射配置

接口说明

接口名称：read_table_headers_file2document_table_headers_post
接口地址：/file2document/table_headers
请求方式：POST

请求参数

参数名	类型	是否必传	描述
file_type	String	是	文件类型： local lark s3
file_id	Number	否	文件ID
doc_id	Number	否	文档ID
header_row	Number	否	用户选择的表头行（从1开始计数）
sheets	Array	否	要读取表头的sheet列表，详情请参见下文 sheets 表
max_columns	Number	否	返回的最大列数，默认200
data_start_row	Number	否	已废弃：接口不再使用此字段
data_connection_id	Number	否	数据连接id
key_list	Array	否	文件路径

sheets

表头工作表选择器

参数名	类型	是否必传	描述
sheet_name	String	否	sheet 名称
sheet_id	String	否	工作表ID
header_row	Number	否	表头行（从1开始计数）
data_start_row	Number	否	已废弃：接口不再使用此字段

响应参数

参数名	类型	是否必传	描述
code	Number	是	响应码：0=成功，非0=失败
msg	String	否	Code非0时，返回错误信息
message	String	否	错误信息
data	Array	否	表格表头数据，详情请参见下文 data 表

data

参数名	类型	是否必传	描述
file_id	Number	是	文件ID
file_name	String	是	文件名
sheets	Array	是	工作表表头信息，详情请参见下文 sheets 表

sheets

参数名	类型	是否必传	描述
sheet_name	String	是	sheet 名称
sheet_id	String	是	工作表ID
columns	Array	否	表头列配置，详情请参见下文 columns 表

columns

参数名	类型	是否必传	描述
source_name	String	否	原始列名
target_name	String	否	导入后的列名
enabled	Boolean	否	是否启用该列参与召回
data_type	String	否	列数据类型
description	String	否	列描述

最近更新时间：2026.07.27 21:58:47

这个页面对您有帮助吗？

有用

有用

无用

无用