Feishu Node icon

Feishu Node

Feishu Node

Actions106

Overview

This node, named "Feishu Node," provides integration with Feishu services. Specifically, for the Resource "云空间" (Cloud Space) and Operation "上传素材通过Url" (Upload Material via URL), it allows users to upload files directly to a specified location in the cloud by providing a URL to the file. This is useful when you want to import external files into your Feishu Cloud Space without manually downloading and re-uploading them.

Practical scenarios include:

  • Automatically importing images or documents referenced by URLs into your Feishu workspace.
  • Migrating or syncing files from external sources into Feishu Cloud Space.
  • Automating content updates by uploading new versions of files hosted elsewhere.

Properties

Name Meaning
上传点的类型 The type of upload target point. Options include:
- 旧版文档图片 (Old version document image)
- 新版文档图片 (New version document image)
- 电子表格图片 (Spreadsheet image)
- 旧版文档文件 (Old version document file)
- 新版文档文件 (New version document file)
- 电子表格文件 (Spreadsheet file)
- Vc 虚拟背景（灰度中，暂未开放）(Virtual background, currently in grayscale, not open)
- 多维表格图片 (Multi-dimensional table image)
- 多维表格文件 (Multi-dimensional table file)
- 同事圈（灰度中，暂未开放）(Colleague circle, currently in grayscale, not open)
- 云文档导入文件 (Cloud document import file)
上传点的 Token The token identifying the upload point within the cloud space. This is required to specify where the file will be uploaded.
文件链接 The URL link of the file to be uploaded.
文件名称 The name to assign to the uploaded file.

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output JSON object contains the result of the upload operation, typically metadata about the uploaded file such as its ID, URL, or status. The exact structure depends on the Feishu API response but generally includes confirmation that the file was successfully uploaded.

If the node supports binary data output, it would represent the uploaded file's binary content or references, but based on the code and properties, this node primarily handles JSON metadata responses.

Dependencies

  • Requires an API key credential for authenticating with Feishu services.
  • Needs network access to Feishu APIs and the URLs provided for uploading.
  • The node uses a resource-operation factory pattern internally to call the appropriate API method.
  • No additional environment variables are explicitly required beyond standard n8n credential configuration.

Troubleshooting

  • Common issues:
    • Invalid or expired upload token (上传点的 Token) may cause authentication failures.
    • Incorrect or inaccessible file URLs (文件链接) can lead to download errors before upload.
    • Unsupported 上传点的类型 values or using options marked as "not open" may cause operation errors.
  • Error messages:
    • Errors thrown during the upload process are caught and logged. If "Continue On Fail" is enabled, the node returns error details per item.
    • Typical errors include network timeouts, permission denied, or invalid parameters.
  • Resolution tips:
    • Verify the upload token is valid and has necessary permissions.
    • Ensure the file URL is publicly accessible or accessible from Feishu servers.
    • Use only supported upload types that are available (avoid those marked as "灰度中，暂未开放").

Links and References

Discussion