飞书项目 icon

飞书项目

飞书项目管理 API 集成，支持工作项、空间、用户、工作流等完整功能

Actions75

用户 → 查询用户信息

AI-generated

Overview

This node operation queries user information within the Feishu project environment. It allows fetching user details by providing one or more identifiers such as user keys, UnionIds, or email addresses. This operation is useful for scenarios where you need to retrieve detailed user data for integration, reporting, or user management purposes within Feishu projects.

Use Case Examples

  1. Query user information by providing a list of user keys to get detailed profiles.
  2. Retrieve user data using UnionIds to unify identities across multiple applications.
  3. Fetch user details by email addresses, ensuring the emails are bound to Feishu accounts.

Properties

Name Meaning
用户Key列表 An array of user keys from the Feishu project. At least one of user_keys, out_ids, or emails must be provided (up to 100). Used to identify users within the project.
UnionId列表 An array of UnionIds from Feishu Open Platform, used to identify unified identities across multiple applications by the same service provider. At least one of user_keys, out_ids, or emails must be provided (up to 100).
邮箱列表 An array of email addresses to query users by email. Emails must be bound to Feishu accounts. At least one of user_keys, out_ids, or emails must be provided (up to 100).
租户Key The saas_tenant_key of the tenant where the user to be queried belongs. Required for email query scenarios when querying users from non-plugin associated tenants.
Options Additional options including batching and timeout settings for the query requests.

Output

JSON

  • user_id - Unique identifier of the user in Feishu.
  • name - Name of the user.
  • email - Email address of the user.
  • mobile - Mobile phone number of the user.
  • department - Department(s) the user belongs to.
  • position - User's job position.
  • status - Current status of the user (e.g., active, inactive).
  • tenant_key - Tenant key indicating the user's tenant in Feishu.

Dependencies

  • Requires Feishu Project API credentials for authentication.

Troubleshooting

  • Ensure at least one of user_keys, out_ids, or emails is provided; otherwise, the query will fail.
  • If querying users from a non-plugin associated tenant by email, the tenant_key parameter must be provided.
  • Batching options must be configured correctly to avoid request overload or timeout issues.
  • Common errors include missing required parameters or invalid user identifiers; verify inputs before execution.

Discussion