Feishu Node

Overview

This node interacts with the Feishu platform to retrieve user information from its address book (通讯录). Specifically, the "获取用户信息" (Get User Information) operation allows users to fetch detailed data about a specific user by specifying their user ID and the type of that ID. This is useful in scenarios where workflows need to enrich data with user details, verify user identities, or integrate Feishu user data into other systems.

Practical examples include:

• Automatically fetching user profiles when processing requests or approvals.
• Synchronizing user data between Feishu and external databases.
• Personalizing notifications or messages based on user attributes retrieved dynamically.

Properties

Name	Meaning
用户ID类型	The type of user ID used for the query. Options: Open ID, Union ID, User ID.
用户ID	The actual user ID value corresponding to the selected 用户ID类型. This is required.
部门ID类型	The type of department ID to be returned in the query results. Options: Department ID, Open Department ID.

Output

The node outputs JSON data containing the user information retrieved from Feishu. Each item corresponds to one input and includes detailed fields about the user as provided by Feishu's API response.

If the node supports binary data output (not explicitly shown in the code), it would typically represent files or media related to the user, but this is not indicated here.

Dependencies

• Requires an API key credential for authenticating with Feishu's API.
• The node depends on the Feishu API service being accessible and properly configured.
• No additional environment variables are explicitly required beyond the API authentication.

Troubleshooting

• Common issues:

  • Incorrect or missing user ID or user ID type can cause the API call to fail.
  • Network connectivity problems or invalid API credentials will result in authentication errors.
  • If the specified user does not exist, the API may return an error or empty result.

• Error messages:

  • Errors thrown during execution are wrapped and reported with context including resource and operation names.
  • If the node is set to continue on failure, errors are captured in the output JSON under an error field.
  • Authentication failures usually indicate invalid or expired API keys; re-authentication is needed.
  • "未实现方法" (Unimplemented method) error indicates that the requested resource-operation combination is not supported.

Links and References

• Feishu Developer Documentation
• Feishu User API Reference (for detailed user info fields)

---

Note: The summary is based solely on static analysis of the provided source code and property definitions without runtime behavior inference.