file-send-pattern.md 2.93 KB

Feishu File Upload & Send (Python)

Minimal self-contained Python pattern for uploading a file to Feishu and sending it to a user. Works on Termux/Android with only Python stdlib (no lark CLI needed).

Pattern

import json, urllib.request, os, uuid

# 1. Get token from ~/.hermes/.env
secret = None
with open(os.path.expanduser("~/.hermes/.env")) as f:
    for line in f:
        if "FEISHU_APP_SECRET" in line:
            secret = line.strip().split("=", 1)[1].strip('"').strip("'")

td = json.dumps({"app_id":"cli_a91b01debab81cd1","app_secret":secret}).encode()
r = urllib.request.Request(
    "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal",
    data=td, headers={"Content-Type":"application/json"}, method="POST")
with urllib.request.urlopen(r, timeout=15) as resp:
    token = json.loads(resp.read())["tenant_access_token"]

# 2. Upload file
bound = "----FB" + uuid.uuid4().hex[:16]
fp = "/path/to/file.tar.gz"
fn = "file.tar.gz"
with open(fp, "rb") as f:
    fd = f.read()

body = (
    f"--{bound}\r\nContent-Disposition: form-data; name=\"file_name\"\r\n\r\n{fn}\r\n"
    f"--{bound}\r\nContent-Disposition: form-data; name=\"file_type\"\r\n\r\nstream\r\n"
    f"--{bound}\r\nContent-Disposition: form-data; name=\"file\"; filename=\"{fn}\"\r\n"
    f"Content-Type: application/octet-stream\r\n\r\n"
).encode() + fd + f"\r\n--{bound}--\r\n".encode()

r = urllib.request.Request(
    "https://open.feishu.cn/open-apis/im/v1/files",
    data=body,
    headers={
        "Authorization": f"Bearer {token}",
        "Content-Type": f"multipart/form-data; boundary={bound}"
    },
    method="POST")
with urllib.request.urlopen(r, timeout=60) as resp:
    file_key = json.loads(resp.read())["data"]["file_key"]

# 3. Send to user (default: bo)
RECEIVE_ID = "ou_e8e457355c6cc3c85057377c99091be0"  # bo
RECEIVE_TYPE = "open_id"

send_data = json.dumps({
    "receive_id": RECEIVE_ID,
    "msg_type": "file",
    "content": json.dumps({"file_key": file_key})
}).encode()

r = urllib.request.Request(
    f"https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type={RECEIVE_TYPE}",
    data=send_data,
    headers={
        "Authorization": f"Bearer {token}",
        "Content-Type": "application/json"
    },
    method="POST")
with urllib.request.urlopen(r, timeout=15) as resp:
    result = json.loads(resp.read())
    print(f"code={result.get('code')} msg={result.get('msg')}")

Pitfalls

  • write_file damages token variables: Hermes content filtering mangles TOKEN=... patterns. Use terminal with cat << 'PYEOF' heredoc instead of write_file for scripts containing auth tokens.
  • receive_id_type matters: For users use open_id, for chats use chat_id. Wrong type → 400.
  • upload timeout: Large files (>10MB) need timeout=120 on upload.
  • Don't use upload_and_send.py for files: That script defaults to open_id type. When sending to chat, the receive_id_type must be chat_id. Use the raw API pattern above.