Python SDK 接入飞书多维表格写入数据指南

方案二：使用 requests 库（原生 API）

如果你不想依赖 SDK，直接用 requests 调用接口也是可以的。这种方式更底层，适合理解整个鉴权流程。

import requests

# ================= 配置信息 =================
APP_ID = "cli_xxxx"
APP_SECRET = "2JBE7yyyyyy"
APP_TOKEN = "VvgbbVCOzalrcfsxxxxxxx"
TABLE_ID = "tblMGgT4yyyyyyy"
# ===========================================

def get_tenant_access_token(app_id, app_secret):
    """获取访问凭证 (tenant_access_token)"""
    url = "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal"
    headers = {"Content-Type": "application/json; charset=utf-8"}
    payload = {
        "app_id": app_id,
        "app_secret": app_secret
    }
    response = requests.post(url, headers=headers, json=payload)
    if response.status_code == 200:
        return response.json().get("tenant_access_token")
    else:
        raise Exception(f"获取 Token 失败：{response.text}")

def add_record(access_token, app_token, table_id, data_fields):
    """向多维表格添加一条记录"""
    url = f"https://open.feishu.cn/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records"
    headers = {
        "Authorization": f"Bearer {access_token}",
        "Content-Type": "application/json; charset=utf-8"
    }
    # 构建请求体
    payload = {
        "fields": data_fields  # 这里的 keys 必须对应多维表格里的列名
    }
    response = requests.post(url, headers=headers, json=payload)
    return response.json()

def save_to_feishu(text_content):
    try:
        # 1. 获取 Token
        token = get_tenant_access_token(APP_ID, APP_SECRET)
        print("Token 获取成功")

        # 2. 准备要保存的数据
        # 注意：字典的 Key 必须完全匹配多维表格的【字段名称】
        text_data = {
            "消息内容": text_content
        }

        # 3. 写入数据
        result = add_record(token, APP_TOKEN, TABLE_ID, text_data)
        if result.get("code") == 0:
            print("数据保存成功！记录 ID:", result["data"]["record"]["record_id"])
        else:
            print("保存失败:", result)
    except Exception as e:
        print("发生错误:", e)

if __name__ == "__main__":
    save_to_feishu('内容：卖出：1000ETF(159629.XSHE:2.512) - 中证 2000 策略')

两种方案本质逻辑一致，SDK 封装了部分细节，原生 API 则更灵活。实际开发中根据项目依赖情况选择即可。