Feishu Node icon

Feishu Node

Feishu Node

Actions106

Overview

This node interacts with the Feishu platform to perform various operations related to its resources. Specifically, for the "日历" (Calendar) resource and the "查询主日历信息" (Get Primary Calendar Information) operation, it retrieves the primary calendar details of a user identified by a specified type of user ID. This is useful in scenarios where you want to programmatically access a user's main calendar information from Feishu, such as integrating calendar data into workflows, syncing events, or displaying calendar summaries.

Example use cases:

  • Fetching a user's primary calendar info to display upcoming events in a dashboard.
  • Integrating Feishu calendar data with other scheduling or notification systems.
  • Automating calendar-based workflows based on the primary calendar's metadata.

Properties

Name Meaning
用户 ID 类型 The type of user identifier used to specify the target user. Options: Open ID, Union ID, User ID

Output

The node outputs an array of JSON objects representing the retrieved primary calendar information for each input item processed. Each JSON object contains the calendar data returned by Feishu's API corresponding to the specified user ID type.

If the node supports binary data output, it is not indicated in the provided code or properties, so the output is purely JSON structured data.

Dependencies

  • Requires an API key credential for authenticating with the Feishu platform.
  • Needs proper configuration of this credential within n8n to enable API calls.
  • Depends on the Feishu API being accessible and the user having permissions to query calendar information.

Troubleshooting

  • Common issues:
    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect user ID type or invalid user identifiers may result in errors or empty responses.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:
    • Errors thrown during the API call are caught and logged. If "Continue On Fail" is enabled, errors are returned as part of the output JSON with an error field describing the issue.
    • If not continuing on failure, errors will halt execution and provide detailed error messages including stack traces.
  • Resolutions:
    • Verify that the API key credential is correctly set up and has necessary permissions.
    • Confirm the user ID and user ID type are valid and correspond to existing users.
    • Check network connectivity and Feishu API status.

Links and References

Discussion