Actions28
- File Actions
- Multipart Upload File Actions
- Permission Member Actions
- Permissionpublic Actions
- Statistic Actions
- Media Actions
- Multipart Upload Media Actions
- Comment Actions
- Subscription Actions
- Document Import Actions
Overview
This node, named "Lark Files," is designed to manage files within the Lark (Feishu) ecosystem. Specifically, for the Resource "Media" and Operation "Obtain A Temporary Material Download Url," it retrieves temporary download URLs for specified media files using their file tokens. This functionality is useful when you need to programmatically access or share media files stored in Lark without permanently exposing direct links.
Common scenarios include:
- Automating workflows that require downloading or previewing media files from Lark.
- Integrating Lark media content into other applications by obtaining secure, time-limited URLs.
- Managing file access permissions dynamically by generating temporary URLs on demand.
Example: Given a list of file tokens representing images or documents uploaded to Lark, this node can fetch temporary URLs that allow these files to be downloaded or embedded elsewhere securely.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating API requests. Options: "Tenant Token" or "OAuth2". |
| File Tokens | A string containing one or more file tokens identifying the media files to obtain URLs for. |
| Options | Additional optional settings: • Use Custom Body (boolean): Whether to send a custom request body instead of default. |
Output
The node outputs JSON data containing the temporary download URLs corresponding to the provided file tokens. The structure typically includes fields such as the file token and its associated temporary URL valid for a limited time.
If the node supports binary data output (not explicitly shown here), it would represent the actual media content fetched via the temporary URLs, but based on the provided code and properties, the primary output is JSON with URL information.
Dependencies
- Requires an active connection to the Lark (Feishu) Open API.
- Needs authentication credentials configured in n8n, either via a Tenant Token or OAuth2 token.
- Network access to
https://open.larksuite.com/open-apisendpoint.
Troubleshooting
- Invalid or expired file tokens: Ensure the file tokens provided are correct and have not expired or been revoked.
- Authentication errors: Verify that the selected authentication method is properly configured with valid credentials.
- API rate limits or network issues: Temporary failures may occur due to API throttling or connectivity problems; retry after some time.
- Incorrect property usage: If "Use Custom Body" is enabled, ensure the custom body format matches API expectations to avoid request errors.