Feishu Node icon

Feishu Node

Feishu Node

Actions61

Overview

This n8n custom node interacts with the Feishu (Lark) 多维表格 (Bitable) service. Specifically, for the resource "多维表格" and operation "列出视图", it lists all views of a specified Bitable table. This is useful for automating workflows that need to retrieve available views from a Feishu Bitable, such as synchronizing data, reporting, or dynamically selecting a view for further processing.

Example scenarios:

  • Fetching all views of a Bitable to present options in a user interface.
  • Automating reports based on different table views.
  • Integrating Feishu Bitable data into other systems by first listing available views.

Properties

Name Type Meaning
多维表格 Token String The unique identifier (token) for the Feishu Bitable App. Required for authentication and identifying the app context.
多维表格 ID String The unique identifier for the specific Bitable table whose views are to be listed.
分页大小 Number Page size; determines how many results are returned per request. Useful for paginating through large numbers of views.
分页标记 String Pagination token; leave empty for the first request. If more results are available, a new token will be provided for subsequent requests.
用户 ID 类型 Options Specifies the type of user ID used in the request. Options include Open_id, Union_id, and User_id. Defaults to Open_id.

Output

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

{
  "view_id": "string",
  "name": "string",
  "type": "string",
  // ...other metadata about the view
}

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.
  • API Credentials: You must configure feishuCredentialsApi in n8n with valid credentials for your Feishu account/app.
  • Environment: No additional environment variables are required beyond standard n8n credential configuration.

Troubleshooting

  • Missing Method Error:
    If you see an error like 未实现方法: bitable.bitable:table:view:list, it means the requested resource-operation combination is not implemented in the node. Double-check that you have selected the correct resource and operation.
  • Authentication Errors:
    If authentication fails, ensure your Feishu credentials are correctly set up in n8n and have sufficient permissions for the Bitable API.
  • Pagination Issues:
    If not all views are returned, check if a 分页标记 (page token) is provided in the response and use it for subsequent requests to fetch additional pages.
  • API Limitations:
    Large tables or frequent requests may hit rate limits imposed by Feishu. Consult the Feishu API documentation for details.

Links and References

Discussion