在使用 Python 操作飞书多维表格记录时，需要结合飞书开放平台提供的 API 接口进行数据交互。以下是针对操作飞书多维表格记录的详细说明和代码示例。 ### 1. 获取多维表格记录 飞书多维表格的数据读取接口支持分页获取，每次请求返回一个 `page_token`，用于下一页数据的查询。对于大量数据的情况，必须通过循环或递归方式多次请求以获取完整数据集。 #### 示例：通过 while 循环读取所有分页数据 ```python import requests def get_all_records(token, table_id): url = f"https://open.feishu.cn/open-apis/bitable/v1/apps/{table_id}/tables/table_id/records" headers = { "Authorization": f"Bearer {token}", "Content-Type": "application/json" } params = {"page_size": 100} all_records = [] while True: response = requests.get(url, headers=headers, params=params) data = response.json() records = data.get("data", {}).get("items", []) all_records.extend(records) page_token = data.get("data", {}).get("page_token") if not page_token: break params["page_token"] = page_token return all_records ``` ### 2. 创建多维表格记录 可以通过 POST 请求向指定多维表中添加新记录。需要提供字段值的 JSON 数据作为请求体。 #### 示例：创建一条新的记录 ```python def create_record(token, table_id, new_data): url = f"https://open.feishu.cn/open-apis/bitable/v1/apps/{table_id}/tables/table_id/records" headers = { "Authorization": f"Bearer {token}", "Content-Type": "application/json" } payload = {"fields": new_data} response = requests.post(url, headers=headers, json=payload) return response.json() ``` ### 3. 更新多维表格记录 更新记录时，需要提供记录的唯一标识（record_id）以及要修改的字段值。 #### 示例：更新某条记录 ```python def update_record(token, table_id, record_id, updated_data): url = f"https://open.feishu.cn/open-apis/bitable/v1/apps/{table_id}/tables/table_id/records/{record_id}" headers = { "Authorization": f"Bearer {token}", "Content-Type": "application/json" } payload = {"fields": updated_data} response = requests.put(url, headers=headers, json=payload) return response.json() ``` ### 4. 删除多维表格记录 删除记录时需提供记录 ID，并发送 DELETE 请求。 #### 示例：删除某条记录 ```python def delete_record(token, table_id, record_id): url = f"https://open.feishu.cn/open-apis/bitable/v1/apps/{table_id}/tables/table_id/records/{record_id}" headers = { "Authorization": f"Bearer {token}" } response = requests.delete(url, headers=headers) return response.json() ``` ### 注意事项 - 在调用 API 前，请确保已正确配置访问令牌 (Access Token) 和应用权限。 - 多维表格的操作依赖于飞书 API 的版本和路径参数是否准确，例如 `app_token` 和 `table_id` 需要替换为实际值[^1]。 - 分页读取过程中，务必检查响应中的 `page_token` 是否存在，否则可能遗漏部分数据。