Feishu Node

Actions61

Overview

This n8n custom node interacts with the Feishu (Lark) platform, specifically targeting the "多维表格" (Bitable, or Multi-dimensional Table) resource. The operation "获取多维表格元数据" ("Get Bitable Metadata") retrieves metadata about a specific Bitable application within Feishu. This is useful for automating workflows that need to inspect table structures, columns, and other configuration details before performing further actions such as data extraction, updates, or synchronization.

Practical Example:
You might use this node at the start of a workflow to dynamically fetch the schema of a Bitable app, enabling subsequent steps to adapt to changes in the table structure without manual reconfiguration.

Properties

Name	Type	Meaning
多维表格 Token	String	The unique identifier (token) for the Bitable App whose metadata is needed. Required for authentication and identifying the target table.

Output

The node outputs a JSON object containing the metadata of the specified Bitable app. While the exact structure depends on the Feishu API response, typical fields may include:

Table name
Table ID
List of columns (with their types and properties)
Other configuration or descriptive information about the Bitable

If an error occurs and "Continue On Fail" is enabled, the output will be:

{
  "error": "Error message here"
}

If the error is of type NodeApiError, the output may also include additional error details from the API.

Dependencies

Feishu (Lark) Account: You must have access to a Feishu account and a valid Bitable App.
API Credentials: The node requires n8n credentials named feishuCredentialsApi to authenticate requests.
Environment: No special environment variables are required beyond standard n8n credential setup.

Troubleshooting

Missing or Invalid Token: If the "多维表格 Token" is missing or incorrect, the node will fail with an error indicating authentication or resource not found.
Unimplemented Method Error: If you select a resource/operation combination that is not implemented, you will see an error like:
```
未实现方法: bitable.getMetadata
```
Ensure you are using supported resources and operations.
API Errors: If the Feishu API returns an error (e.g., due to permission issues), the node will output the error message. Check your API credentials and permissions.
Network Issues: Connectivity problems between n8n and Feishu can cause failures. Verify network access and endpoint URLs.