Actions5
Overview
This node, named "Lark Apps," is designed to manage and interact with Lark applications via the Lark Suite Open APIs. Specifically, the "Obtain App Version Information" operation allows users to retrieve detailed version information about a particular Lark app. This can be useful for developers or administrators who need to monitor app versions, verify updates, or integrate version data into workflows.
Practical examples include:
- Automatically checking if an app version has been updated before triggering deployment pipelines.
- Fetching app version details to display in dashboards or reports.
- Validating app version compatibility within automated processes.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating API requests. Options: Tenant Token (using a tenant-level API token) or OAuth2 (using OAuth2 authentication flow). |
| Lang | Language code specifying the language in which app information should be returned. If left empty, defaults to the API's default language. |
| App Id | The unique identifier of the app whose version information is being requested. To query other apps' versions, appropriate permissions are required. Use "me" or the app's own app_id to query its own version info. |
| Version Id | The unique identifier of the specific app version to obtain information about. |
| Options | Additional options for the request. Currently supports: - Use Custom Body (boolean): Whether to send a custom request body instead of the default one. |
Output
The node outputs JSON data containing detailed information about the specified app version. This typically includes fields such as version number, release notes, update time, status, and other metadata related to the app version.
If binary data were involved (e.g., app package files), it would be indicated here, but this operation focuses on JSON metadata only.
Dependencies
- Requires access to the Lark Suite Open APIs.
- Requires either a valid tenant token credential or OAuth2 credentials configured in n8n for authentication.
- Network connectivity to
https://open.larksuite.com/open-apis.
Troubleshooting
- Authentication errors: Ensure that the selected authentication method is properly configured with valid credentials. Tenant tokens must have the necessary scopes to access app version information.
- Permission issues: Querying version info of apps other than your own requires additional API scopes. Verify that the token or OAuth2 user has these permissions.
- Invalid App Id or Version Id: Double-check that the provided IDs are correct and exist in the Lark environment.
- Language parameter issues: If the language code is invalid or unsupported, the API may return default language data or an error.
- Custom Body option misuse: Enabling "Use Custom Body" without providing a proper body format may cause request failures.
Links and References
- Lark Suite Open API Documentation — Official docs for obtaining app version information and related API scopes.