Feishu Node icon

Feishu Node

Feishu Node

Actions61

Overview

This node interacts with the Feishu (Lark) 多维表格 (Bitable) service to "列出数据表" (List Tables) within a specified Bitable application. It is useful for retrieving metadata about all tables in a given Bitable app, which can be leveraged for automation, reporting, or further data processing in n8n workflows.

Common scenarios:

  • Automating the extraction of table lists for dynamic integrations.
  • Building dashboards that require up-to-date information on available tables.
  • Pre-processing steps before fetching or manipulating specific table data.

Example:
A user wants to synchronize the structure of their Feishu Bitable with another database. This node can list all tables, enabling subsequent nodes to fetch schema or data as needed.

Properties

Name Type Meaning
多维表格 Token string The unique identifier (token) for the Bitable App. Required to specify which Bitable's tables to list.
分页标记 string Pagination token. Leave empty for the first request; use the returned value from previous responses to fetch additional pages of results.
分页大小 number Page size. Determines how many tables are returned per request. Default is 20.

Output

The node outputs an array of JSON objects, each representing a table in the specified Bitable app. The exact structure depends on the Feishu API response, but typically includes fields such as:

[
  {
    "table_id": "tblxxxxxx",
    "name": "Table Name",
    "fields": [ ... ],
    // other metadata fields
  }
]

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

{
  "error": "Error message"
}

Dependencies

  • Feishu (Lark) API: Requires access to the Feishu Bitable API.
  • Credentials: Needs a configured feishuCredentialsApi credential in n8n, which should contain the necessary API key/token.
  • Environment: No special environment variables required beyond standard n8n configuration.

Troubleshooting

Common Issues:

  • Invalid Token: If the provided 多维表格 Token is incorrect or expired, the node will fail with an authentication error.
  • Pagination Errors: Incorrect usage of 分页标记 may result in missing or duplicate data.
  • API Limits: Exceeding Feishu API rate limits may cause temporary failures.

Error Messages:

  • 未实现方法: bitable.bitable:table:list: Indicates the requested resource/operation combination is not implemented.
  • NodeApiError: Usually means an issue with the API call (e.g., invalid credentials, network issues). Check the error details in the output.
  • Other errors will be reported with their message in the output if "Continue On Fail" is enabled.

Resolution Steps:

  • Double-check your credentials and token values.
  • Ensure you are using the correct pagination tokens.
  • Review Feishu API documentation for any changes or limitations.

Links and References

Discussion