检索记录

该接口用于根据 record_id 的值检索现有记录。

Warning: 该接口为历史版本接口，已不推荐使用。你可使用新版批量获取记录接口。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/bitable/v1/apps/:app_token/tables/:table_id/records/:record_id
HTTP Method	GET
接口频率限制	20 次/秒
支持的应用类型	custom,isv
权限要求调用该 API 所需的权限。开启其中任意一项权限即可调用开启任一权限即可	`bitable:app` 查看、评论、编辑和管理多维表格 `bitable:app:readonly` 查看、评论和导出多维表格
字段权限要求	> Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 `contact:user.base:readonly` 获取用户基本信息 `contact:user.employee_id:readonly` 获取用户 user ID `contact:contact:access_as_app` 以应用身份访问通讯录 `contact:contact:readonly` 读取通讯录 `contact:contact:readonly_as_app` 以应用身份读取通讯录

请求头

名称	类型	必填	描述
Authorization	string	是	`tenant_access_token` 或 `user_access_token` 值格式："Bearer `access_token`" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token

Note 关于云文档接口的 AccessToken 调用说明详见云文档接口快速入门

路径参数

名称	类型	描述
`app_token`	`string`	base app token 示例值："bascnCMII2ORej2RItqpZZUNMIe"
`table_id`	`string`	table id 示例值："tblxI2tWaxP5dG7p"
`record_id`	`string`	单条记录的 id 示例值："recn0hoyXL"

查询参数

名称	类型	必填	描述
`text_field_as_array`	`boolean`	否	多行文本字段数据是否以数组形式返回。true 表示以数组形式返回。默认为 false 示例值：true
`user_id_type`	`string`	否	用户 ID 类型示例值：open_id 可选值有： - `open_id`: 标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多：如何获取 Open ID - `union_id`: 标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？ - `user_id`: 标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多：如何获取 User ID？默认值：`open_id` 当值为 `user_id`，字段权限要求： `contact:user.employee_id:readonly` 获取用户 user ID
`display_formula_ref`	`boolean`	否	控制公式、查找引用是否显示完整原样的返回结果。默认为 false 示例值：true
`with_shared_url`	`boolean`	否	控制是否返回该记录的链接，即 record_url 参数。默认为 false，即不返回示例值：true
`automatic_fields`	`boolean`	否	控制是否返回自动计算的字段，例如 `created_by`/`created_time`/`last_modified_by`/`last_modified_time`，true 表示返回。默认为 false 示例值：true

响应

响应体

名称	类型	描述
`code`	`int`	错误码，非 0 表示失败
`msg`	`string`	错误描述
`data`	`\-`	-
└ `record`	`app.table.record`	记录
└ `fields`	`map<string, union>`	数据表的字段，即数据表的列当前接口支持的字段类型请参考接入指南不同类型字段的数据结构请参考数据结构概述
└ `record_id`	`string`	一条记录的唯一标识 id record_id 参数说明
└ `created_by`	`person`	该记录的创建人
└ `id`	`string`	用户id，id类型等于user_id_type所指定的类型。
└ `name`	`string`	用户的中文名称
└ `en_name`	`string`	用户的英文名称
└ `email`	`string`	用户的邮箱
└ `avatar_url`	`string`	头像链接字段权限要求（满足任一）： `contact:user.base:readonly` 获取用户基本信息 `contact:contact:access_as_app` 以应用身份访问通讯录 `contact:contact:readonly` 读取通讯录 `contact:contact:readonly_as_app` 以应用身份读取通讯录
└ `created_time`	`int`	该记录的创建时间
└ `last_modified_by`	`person`	该记录最新一次更新的修改人
└ `id`	`string`	用户id，id类型等于user_id_type所指定的类型。
└ `name`	`string`	用户的中文名称
└ `en_name`	`string`	用户的英文名称
└ `email`	`string`	用户的邮箱
└ `avatar_url`	`string`	头像链接字段权限要求（满足任一）： `contact:user.base:readonly` 获取用户基本信息 `contact:contact:access_as_app` 以应用身份访问通讯录 `contact:contact:readonly` 读取通讯录 `contact:contact:readonly_as_app` 以应用身份读取通讯录
└ `last_modified_time`	`int`	该记录最近一次的更新时间

响应体示例

json

{
    "code":0,
    "data":{
        "record":{
            "fields":{
                "人力耗时":64,
                "人力评估":"8",
                "任务执行人":[
                    {
                        "email":"huangpaopao@feishu.cn",
                        "en_name":"Paopao Huang",
                        "id":"ou_5fb00e0112212cc7012fe3a697336989",
                        "name":"黄泡泡"
                    }
                ],
                "任务描述":"我是最大的功能开发🥕",
                "任务附件":[
                    {
                        "file_token":"boxcnkQWfV4XbHwzDngmezMGzXe",
                        "name":"2.gif",
                        "size":10250625,
                        "tmp_url":"https://open.feishu.cn/open-apis/drive/v1/medias/batch_get_tmp_download_url?file_tokens=boxcnkQWfV4XbHwzDngmezMGzXe",
                        "type":"image/gif",
                        "url":"https://open.feishu.cn/open-apis/drive/v1/medias/boxcnkQWfV4XbHwzDngmezMGzXe/download"
                    }
                ],
                "对应 OKR":[
                    {
                        "text":"新功能评审",
                        "type":"text"
                    }
                ],
                "截止日期":1612108800000,
                "文档地址":{
                    "link":"https://example.feishu.cn/drive/home/",
                    "text":"文档备份"
                },
                "是否完成":false,
                "状态":"开发中",
                "相关部门":[
                    "研发"
                ],
                "多行文本":[ // text_field_as_array 为true时的结构
                    {
                        "text":"hello",
                        "type":"text"
                    },
                    {
                        "mentionType":"User",
                        "mentionNotify":false,
                        "name":"test",
                        "text":"@test",
                        "token":"ou_sfsdfsdfsdfsdfdsfsdfdsf",
                        "type":"mention"
                    },
                    {
                        "link":"https://test-sasdfsfsd.feishu-boe.cn/base/basbcq2aFvW8nFJpfOXa1111111",
                        "mentionType":"Bitable",
                        "text":"未命名多维表格",
                        "token":"basbcq2aFvW8nFJpfOXalx57ffb",
                        "type":"mention"
                    },
                    {
                        "text":"测试链接标题",
                        "link":"https://www.baidu.com/",
                        "type":"url"
                    }
                ],
                "单向关联":[
                    {
                        "type":"text",
                        "table_id":"tbltAvx3DYBw7PVj",
                        "record_ids":[
                          "recl1IWVnB"
                        ],
                        "text":"第一行"
                    }
                ],
                "双向关联":[
                    {
                        "table_id":"tbltAvx3DYBw7PVj",
                        "record_ids":[
                          "recl1IWVnB",
                          "recrJk7SXT"
                        ],
                        "text":"第一行,第二行",
                        "type":"text"
                    }
                ]
            },
            "record_id":"recn0hoyXL",
            "record_url": "https://example.feishu.cn/record/1sfvuxxxxxxxxxxxxxKdupE5Q"
        }
    },
    "msg":"Success"
}

错误码

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	1254030	TooLargeResponse	响应体过大
400	1254036	Base 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	1254045	FieldNameNotFound	字段名字不存在
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	1254072	Failed to convert phone field, please make sure it is correct.	电话字段格式错误
200	1254100	TableExceedLimit	数据表数量超限, 限制300个
200	1254101	ViewExceedLimit	视图数量超限, 限制200个
200	1254102	FileExceedLimit	超限
200	1254103	RecordExceedLimit	记录数量超限, 限制20,000条
200	1254104	RecordAddOnceExceedLimit	单次添加记录数量超限, 限制500条
200	1254130	TooLargeCell	格子内容过大
200	1254290	TooManyRequest	请求过快，稍后重试
200	1254291	Write conflict	同一个数据表(table) 不支持并发调用写接口，请检查是否存在并发调用写接口。写接口包括：新增、修改、删除记录；新增、修改、删除字段；修改表单；修改视图等。
200	1254301	OperationTypeError	多维表格未开启高级权限或不支持开启高级权限
200	1254302	Permission denied.	无访问权限, 常由表格开启了高级权限造成, 请在高级权限设置中添加一个包含应用的群, 给予这个群读写权限
200	1254303	AttachPermNotAllow	附件无权限
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	该报错一般是由于前置操作未执行完成，或本次操作数据太大，服务器计算超时导致。遇到该错误码时，建议等待一段时间后重试。通常有以下几种原因： - 编辑操作频繁：开发者对多维表格的编辑操作非常频繁。可能会导致由于等待前置操作处理完成耗时过长而超时的情况。多维表格底层对数据表的处理基于版本维度的串行方式，不支持并发。因此，并发请求时容易出现此类错误，不建议开发者对单个数据表进行并发请求。 - 批量操作负载重：开发者在多维表格中进行批量新增、删除等操作时，如果数据表的数据量非常大，可能会导致单次请求耗时过长，最终导致请求超时。建议开发者适当降低批量请求的 page_size 以减少请求耗时。 - 资源分配与计算开销：资源分配是基于单文档维度的，如果读接口涉及公式计算、排序等计算逻辑，会占用较多资源。例如，并发读取一个文档下的多个数据表也可能导致该文档阻塞。

事件

工作空间枚举

工作空间数据表

工作空间视图

角色

apiRef

内容

文件

文件夹

数据校验

表格操作

货币信息

地点 · 数据

事件

事件

审批 · 搜索

飞书原生审批

应用商店集成

第三方审批集成

检索记录 ​

请求 ​

请求头 ​

路径参数 ​

查询参数 ​

响应 ​

响应体 ​

响应体示例 ​

错误码 ​

检索记录

请求

请求头

路径参数

查询参数

响应

响应体

响应体示例

错误码