查询字段

本接口用于获取智能表中某个子表下字段信息，该接口可以完成下面三种功能：获取全部字段信息、依据字段名获取对应字段、依据字段 ID 获取对应字段信息。

请求方式：POST(HTTPS)
请求地址：https://qyapi.weixin.qq.com/cgi-bin/wedoc/smartsheet/get_fields?access_token=ACCESS_TOKEN

请求包体：

{
	"docid": "DOCID",
	"sheet_id": "SHEETID",
	"offset": 0,
	"limit": 10
}

参数说明

权限说明

• 自建应用需配置到“可调用应用”列表中的应用secret所获取的accesstoken来调用（accesstoken如何获取？）

返回示例

{
	"errcode": 0,
	"errmsg": "ok",
	"total": 1,
	"fields": [{
		"field_id": "ID1",
		"field_title": "TITLE1",
		"field_type": "FIELD_TYPE_TEXT"
	}]
}

参数说明

参数详细说明

Field

字段信息：

注意

字段属性与字段类型是匹配的，一种字段类型对应一种字段属性

FieldType

NumberFieldProperty

数字类型字段属性信息：

CheckboxFieldProperty

复选框类型字段属性信息：

DateTimeFieldProperty

日期类型字段属性信息：

AttachmentFieldProperty

文件类型字段属性信息：

UserFieldProperty

成员类型字段属性信息：

UrlFieldProperty

超链接类型字段属性信息：

SelectFieldProperty

多选类型字段属性信息：

CreatedTimeFieldProperty

创建时间类型字段属性信息：

ModifiedTimeFieldProperty

最后编辑时间类型字段属性信息：

ProgressFieldProperty

进度类型字段属性信息：

SingleSelectFieldProperty

单选类型字段属性信息：

ReferenceFieldProperty

关联字段属性信息：

LocationFieldProperty

地理位置字段属性信息：

AutoNumberFieldProperty

自动编号字段属性信息：

CurrencyFieldProperty

货币类型字段属性

WwGroupFieldProperty

群类型的字段属性

DecimalPlaces

小数点后的位数：

Format

日期格式：

LinkType

超链接展示样式可选值：

Option

Option 参数：

Style

选项颜色：

DisplayMode

展示样式

LocationInputType

地理位置输入类型

NumberType

自动编号类型

NumberRule

CreateTimeFormat

NumberRuleType

数字规则类型

CurrencyType

货币符号