Actions16
- App Actions
- Data Actions
- Entry Actions
- File Actions
- Workflow Actions
Overview
This node integrates with the Jiandaoyun API, providing various operations on different resources such as apps, entries, data records, files, and workflows. Specifically, for the File resource with the Upload File operation, the node uploads a binary file to a specified URL using provided upload credentials (token). This is useful when you want to programmatically upload files to Jiandaoyun forms or applications as part of an automated workflow.
Common scenarios include:
- Automating file uploads to Jiandaoyun forms after processing or generating files in n8n.
- Integrating external systems that produce files with Jiandaoyun by uploading those files automatically.
- Handling batch or single file uploads within complex automation workflows.
Example: Uploading a PDF report generated in a previous step directly into a Jiandaoyun form entry by specifying the upload URL and token obtained from Jiandaoyun's upload token API.
Properties
| Name | Meaning |
|---|---|
| App ID | The identifier of the Jiandaoyun app where the file will be uploaded. |
| Entry ID | The identifier of the specific entry/form within the app related to the file upload. |
| URL | The file upload URL provided by Jiandaoyun to which the file will be sent. |
| Token | The upload credential token required to authorize the file upload request. |
| Input Binary Field | The name of the input binary field in the incoming data that contains the file to be uploaded. |
Output
The node outputs JSON data representing the response from the Jiandaoyun API after attempting the file upload. The structure depends on the API response but typically includes information about the success or failure of the upload, any metadata returned by Jiandaoyun, and possibly identifiers for the uploaded file.
If the node processes binary data, it uses the specified binary input field to read the file content and uploads it accordingly. The output does not contain binary data itself but reflects the result of the upload operation.
Dependencies
- Requires an active Jiandaoyun API credential configured in n8n to authenticate requests.
- Needs access to the Jiandaoyun API server URL, which is retrieved from the credential.
- The file upload requires a valid upload URL and token, usually obtained from a prior "Get Upload Token" operation.
- The node uses multipart/form-data encoding to send the file content.
Troubleshooting
- Missing or invalid upload URL/token: Ensure that the URL and token parameters are correctly set and correspond to a valid upload session. Invalid tokens or URLs will cause upload failures.
- Binary data not found: If the specified binary input field does not exist or is empty in the input data, the node will fail to upload the file. Verify the binary property name matches the actual input.
- Incorrect App ID or Entry ID: These must match existing Jiandaoyun app and entry identifiers; otherwise, the API may reject the request.
- API errors: The node throws errors if the Jiandaoyun API returns error responses. Check the error message for details and verify all parameters.
- Data format issues: The node expects the binary data to be properly formatted and accessible. Corrupted or unsupported file formats might cause upload errors.
Links and References
- Jiandaoyun Official API Documentation — For details on file upload tokens and API usage.
- n8n Expressions Documentation — For constructing dynamic expressions in properties.
- Multipart Form Data in HTTP Requests — Understanding how file uploads work over HTTP.