Feishu Node icon

Feishu Node

Feishu Node

Actions106

Overview

This node integrates with the Feishu platform to perform batch addition of records into a multi-dimensional table (多维表格). It is designed to efficiently insert multiple records in one operation, which is useful for bulk data imports or synchronizing large datasets from other systems.

Common scenarios include:

  • Importing large sets of structured data into a Feishu multi-dimensional table.
  • Automating data entry workflows where multiple records need to be created simultaneously.
  • Synchronizing external databases or spreadsheets with Feishu tables in batch mode.

For example, a user might use this node to upload hundreds of customer records at once into a Feishu table used for CRM purposes.

Properties

Name Meaning
多维表格 Token The unique identifier token for the Feishu App. This authenticates and scopes the request to the specific app instance.
多维表格 ID The unique identifier of the multi-dimensional table within Feishu where records will be added.
用户 ID 类型 The type of user ID used in the operation. Options are: Open ID, Union ID, or User ID. This defines how users are identified in the context of the operation.
操作的唯一标识 A unique client token for the operation, used for idempotency. If empty, a new request is initiated; if provided, it ensures the update operation is idempotent by matching the token returned from previous calls.
是否忽略一致性读写检查 Boolean flag indicating whether to ignore consistency read/write checks. Defaults to true, meaning the node will skip these checks unless set otherwise.
请求体JSON The JSON body of the request containing the records to add. Must follow the structure defined by Feishu's API for batch creating records. Typically includes an array of record objects under the records key.

Output

The node outputs an array of JSON objects representing the response from the Feishu API after attempting to batch add records. Each object corresponds to the result of the batch operation, including success or error details per record as returned by the API.

If the API supports binary data output (not indicated here), it would typically represent attachments or files related to the records, but this node focuses on JSON data only.

Dependencies

  • Requires an API authentication token credential for Feishu (referred generically as "an API key credential").
  • The node depends on Feishu's multi-dimensional table API endpoint for batch record creation.
  • Proper configuration of the Feishu App and permissions to access and modify the specified table are necessary.
  • The JSON request body must conform to Feishu's documented schema for batch record creation: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table-record/batch_create#requestBody

Troubleshooting

  • Common issues:

    • Invalid or expired token leading to authentication errors.
    • Incorrect table ID causing resource not found errors.
    • Malformed JSON in the request body resulting in validation errors.
    • Idempotency token misuse causing unexpected behavior in repeated requests.

  • Error messages:

    • Authentication failures: Check that the provided token is valid and has required permissions.
    • Resource not found: Verify the table ID is correct and accessible by the app.
    • JSON parsing errors: Ensure the request body JSON is well-formed and matches the expected schema.
    • Idempotency conflicts: Use unique client tokens for distinct operations or leave empty for new requests.

Links and References

Discussion