列出字段
GET
/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/fields
自建应用商店应用
该接口支持调用频率上限为 20 QPS
错误码
HTTP状态码 | 错误码 | 描述 | 排查建议 |
---|---|---|---|
200 | 1254000 | WrongRequestJson | 请求体错误 |
200 | 1254001 | WrongRequestBody | 请求体错误 |
200 | 1254002 | Fail | 内部错误,有疑问可咨询客服 |
200 | 1254003 | WrongBaseToken | app_token 错误 |
200 | 1254004 | WrongTableId | table_id 错误 |
200 | 1254005 | WrongViewId | view_id 错误 |
200 | 1254006 | WrongRecordId | 检查 record_id |
200 | 1254007 | EmptyValue | 空值 |
200 | 1254008 | EmptyView | 空视图 |
200 | 1254009 | WrongFieldId | 字段 id 错误 |
200 | 1254010 | ReqConvError | 请求错误 |
200 | 1254012 | NotSupportFieldOrView | 不支持的字段或视图 |
200 | 1254013 | TableNameDuplicated | 表名重复 |
200 | 1254014 | FieldNameDuplicated | 字段名重复 |
200 | 1254015 | FieldTypeValueNotMatch | 字段类型和值不匹配 |
200 | 1254030 | TooLargeResponse | 响应体过大 |
400 | 1254036 | Bitable is copying, please try again later. | 多维表格副本复制中,稍后重试 |
200 | 1254040 | BaseTokenNotFound | app_token 不存在 |
200 | 1254041 | TableIdNotFound | table_id 不存在 |
200 | 1254042 | ViewIdNotFound | view_id 不存在 |
200 | 1254043 | RecordIdNotFound | record_id 不存在 |
200 | 1254044 | FieldIdNotFound | field_id 不存在 |
200 | 1254060 | TextFieldConvFail | 多行文本字段错误 |
200 | 1254061 | NumberFieldConvFail | 数字字段错误 |
200 | 1254062 | SingleSelectFieldConvFail | 单选字段错误 |
200 | 1254063 | MultiSelectFieldConvFail | 多选字段错误 |
200 | 1254064 | DatetimeFieldConvFail | 日期字段错误 |
200 | 1254065 | CheckboxFieldConvFail | 复选框字段错误 |
200 | 1254066 | UserFieldConvFail | 人员字段错误 |
200 | 1254067 | LinkFieldConvFail | 关联字段错误 |
200 | 1254070 | ActionValidateFailed | Action验证失败 |
200 | 1254100 | TableExceedLimit | 数据表数量超限, 限制300个 |
200 | 1254101 | ViewExceedLimit | 视图数量超限, 限制200个 |
200 | 1254102 | FileExceedLimit | 超限 |
200 | 1254103 | RecordExceedLimit | 记录数量超限, 限制20,000条 |
200 | 1254104 | RecordAddOnceExceedLimit | 单次添加记录数量超限, 限制500条 |
200 | 1254105 | ColumnExceedLimit | 字段数量超限 |
200 | 1254130 | TooLargeCell | 格子内容过大 |
200 | 1254290 | TooManyRequest | 请求过快,稍后重试 |
200 | 1254291 | Write conflict | 同一个数据表(table) 不支持并发调用写接口,请检查是否存在并发调用写接口。写接口包括:新增、修改、删除记录;新增、修改、删除字段;修改表单;修改视图等。 |
200 | 1254301 | OperationTypeError | 多维表格未开启高级权限或不支持开启高级权限 |
200 | 1255001 | InternalError | 内部错误,有疑问可咨询客服 |
200 | 1255002 | RpcError | 内部错误,有疑问可咨询客服 |
200 | 1255003 | MarshalError | 序列化错误,有疑问可咨询客服 |
200 | 1255004 | UmMarshalError | 反序列化错误 |
200 | 1255005 | ConvError | 内部错误,有疑问可咨询客服处 |
504 | 1255040 | 请求超时 | 进行重试 |
400 | 1254607 | Data not ready, please try again later | 出现这个错误通常有两种情况:1. 上次提交的修改还没有处理完;2. 数据太大,服务器计算超时;遇到这个错误码可以适当进行重试。 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://open.feishu.cn/open-apis/bitable/v1/apps/appbcbWCzen6D8dezhoCH2RpMAh/tables/tblsRc9GRRXKqhvW/fields' \
--header 'Authorization;'
响应示例响应示例
{
"code": 0,
"data": {
"has_more": false,
"items": [
{
"field_id": "fldjX7dUj5",
"field_name": "多行文本",
"property": null,
"type": 1
},
{
"field_id": "fldoMnnvIR",
"field_name": "数字",
"property": {
"formatter": "0.00"
},
"type": 2
},
{
"field_id": "fld2RxOyB8",
"field_name": "单选",
"property": {
"options": [
{
"color": 0,
"id": "optpeuQVqp",
"name": "a++"
},
{
"color": 1,
"id": "opt5g3xLFT",
"name": "b"
},
{
"color": 6,
"id": "opt558YmTi",
"name": "z"
}
]
},
"type": 3
},
{
"field_id": "fldHBDkAfH",
"field_name": "日期",
"property": {
"auto_fill": false,
"date_formatter": "yyyy/MM/dd HH:mm"
},
"type": 5
},
{
"field_id": "fld1lAbHh7",
"field_name": "复选框",
"property": null,
"type": 7
},
{
"field_id": "fldlQDzjyK",
"field_name": "人员",
"property": {
"multiple": true
},
"type": 11
},
{
"field_id": "fldEahozCL",
"field_name": "超链接",
"property": null,
"type": 15
},
{
"field_id": "fldxZLsTge",
"field_name": "附件",
"property": null,
"type": 17
},
{
"field_id": "fldNdr8VNW",
"field_name": "单向关联",
"property": {
"multiple": true,
"table_id": "tblw92ErelmCmgHc",
"table_name": "数据表2"
},
"type": 18
},
{
"field_id": "fldNaywkor",
"field_name": "查找引用",
"property": null,
"type": 19
},
{
"field_id": "fldFuAdYEI",
"field_name": "公式",
"property": {
"formatter": "0.00%",
"formula_expression": "IF(bitable::$table[tblxxxxxxxxxxxxx].$field[fldxxxxxxx].CONTAIN(\"飞书\"),\"aaa\",\"bbb\")"
},
"type": 20
},
{
"field_id": "fldpfIDIi0",
"field_name": "双向关联",
"property": {
"back_field_id": "fldmQGUnWh",
"back_field_name": "双向关联-自动生成",
"multiple": true,
"table_id": "tblw92ErelmCmgHc",
"table_name": "数据表2"
},
"type": 21
},
{
"field_id": "fldoblwmUC",
"field_name": "创建时间",
"property": {
"date_formatter": "yyyy/MM/dd"
},
"type": 1001
},
{
"field_id": "fldd1bPCW7",
"field_name": "创建人",
"property": null,
"type": 1003
},
{
"field_id": "fldZXPWBrP",
"field_name": "电话号码",
"type": 13,
"property": null
},
{
"field_id": "fldtuzPEKC",
"field_name": "地理位置",
"type": 22,
"property": {
"location": {
"input_type": "not_limit"
}
}
},
{
"field_id": "fldEG65yiU",
"field_name": "自动编号",
"type": 1005,
"property": {
"auto_serial": {
"type": "custom",
"options": [
{
"value": "1",
"type": "system_number"
},
{
"value": "MMdd",
"type": "created_time"
},
{
"type": "created_time",
"value": "yyyyMMdd"
},
{
"type": "created_time",
"value": "MM"
}
]
}
}
},
{
"field_id": "fldwq16vz2",
"field_name": "自增数字自动编号",
"type": 1005,
"property": {
"auto_serial": {
"type": "auto_increment_number"
}
}
}
],
"page_token": "fldd1bPCW7",
"total": 18
},
"msg": "Success"
}
请求参数
Path 参数
app_token
必需
示例值:
appbcbWCzen6D8dezhoCH2RpMAh
table_id
table id
示例值:
tblsRc9GRRXKqhvW
Query 参数
view_id
视图 ID
示例值:
vewOVMEXPF
page_token
可选
示例值:
fldwJ4YrtB
page_size
分页大小
示例值:
10
text_field_as_array
string
可选
示例值:
true
Header 参数
Authorization
string
必需
默认值:
Bearer {{access_token}}
返回响应
修改于 2023-01-18 08:10:13