Jiandaoyun icon

Jiandaoyun

Consume Jiandaoyun API

Overview

This node integrates with the Jiandaoyun API, enabling users to interact with various Jiandaoyun resources such as apps, entries, data records, files, and workflows. It supports operations like retrieving app or entry information, managing data records (create, update, delete, retrieve), handling file uploads, and working with workflow instances and tasks.

Common scenarios include:

  • Automating data retrieval and updates in Jiandaoyun forms.
  • Bulk creating or updating multiple data records.
  • Uploading files to Jiandaoyun storage.
  • Managing workflow tasks and approvals programmatically.

For example, a user can automate fetching all entries of a specific app or create new data records based on external triggers.

Properties

Name Meaning
App ID The identifier of the Jiandaoyun app to operate on. Required for most operations except some workflow ones.
Entry ID The identifier of the Jiandaoyun entry (form) within an app. Required for data-related operations.

Note: The above two properties are required inputs for many operations but hidden for certain workflow resource operations.

Output

The node outputs JSON data representing the response from the Jiandaoyun API corresponding to the requested operation. The structure varies depending on the operation:

  • For list operations (e.g., getApps, getEntries), it returns arrays of app or entry objects.
  • For data record operations, it returns details of created, updated, deleted, or retrieved records.
  • For file upload operations, it handles binary data input and returns upload confirmation or tokens.
  • For workflow operations, it returns workflow instance details, task lists, or approval results.

If the operation involves uploading files, the node expects binary input data and processes it accordingly.

Dependencies

  • Requires an API authentication credential for Jiandaoyun (an API key or token).
  • Needs proper configuration of the Jiandaoyun API server URL in credentials.
  • Uses n8n helper methods for authenticated HTTP requests and binary data handling.

Troubleshooting

  • Error: "Not implemented yet" — This error indicates that the selected resource-operation combination is not supported by the node. Verify that the chosen operation is valid for the resource.
  • Invalid JSON input errors — When providing JSON fields (e.g., dataRecordJson, filter), ensure the JSON syntax is correct and matches expected formats.
  • Array expected errors — Some operations require JSON arrays (e.g., dataRecordIdsJson, dataRecordJson for batch operations). Passing non-array JSON will cause errors.
  • Missing required parameters — Ensure required fields like App ID, Entry ID, Data ID, or transaction IDs are provided when needed.
  • Binary data issues during file upload — Confirm the binary property name matches the input binary field containing the file and that the binary data is correctly attached.

Links and References

Discussion