Actions16
- App Actions
- Data Actions
- Entry Actions
- File Actions
- Workflow Actions
Overview
This node interacts with the Jiandaoyun API to perform various operations related to apps, data entries, files, and workflows. Specifically for the File resource and the Get Upload Token operation, it retrieves upload tokens that are necessary for securely uploading files to Jiandaoyun. This is useful when you want to programmatically obtain credentials and URLs to upload files in a batch or single file upload scenario.
Common scenarios include:
- Preparing to upload files by first obtaining an upload token tied to a specific transaction.
- Managing file uploads in automated workflows where files need to be attached to form entries.
- Ensuring secure and authorized file uploads by using tokens generated via this operation.
Example: Before uploading images or attachments to a form entry, use this operation to get an upload token associated with a unique transaction ID (usually a UUID). Then use the token to upload files securely.
Properties
| Name | Meaning |
|---|---|
| App ID | The identifier of the app within Jiandaoyun where the file upload will be associated. |
| Entry ID | The identifier of the entry (form) within the app to which the file upload relates. |
| Transaction ID | A user-generated unique identifier (recommended to be a UUID) used to bind a batch of uploaded files together. Required for obtaining upload tokens. |
Output
The output JSON contains the response from the Jiandaoyun API endpoint /api/v5/app/entry/file/get_upload_token. This typically includes one or more upload tokens that authorize subsequent file uploads under the specified transaction ID.
The structure generally includes fields such as:
- Upload token(s) for authenticating file uploads.
- Possibly metadata about the upload session or limits.
No binary data is output by this operation; it only returns JSON data containing upload credentials.
Dependencies
- Requires an active Jiandaoyun API credential configured in n8n to authenticate requests.
- The node makes HTTP POST requests to the Jiandaoyun server URL defined in the credentials.
- The
transactionIdmust be generated externally by the user (recommended UUID format). - No additional external dependencies beyond the Jiandaoyun API and n8n's HTTP request capabilities.
Troubleshooting
- Missing or invalid transactionId: The operation requires a valid transaction ID. Ensure you generate a proper UUID or unique string before calling this operation.
- Invalid App ID or Entry ID: If these IDs do not correspond to existing resources in Jiandaoyun, the API will return errors. Verify the IDs are correct.
- Authentication errors: Make sure the Jiandaoyun API credentials are correctly set up and have sufficient permissions.
- API rate limits or quota exceeded: If many tokens are requested rapidly, the API might throttle requests. Implement retries or delays if needed.
- Malformed JSON or missing parameters: Since the node sends JSON bodies, ensure all required parameters are provided and correctly formatted.
Links and References
- Jiandaoyun API Documentation - File Upload Token
- UUID Generation Reference (for generating transaction IDs)
If you need details on other operations or resources, feel free to ask!