Jiandaoyun icon

Jiandaoyun

Consume Jiandaoyun API

Overview

This node interacts with the Jiandaoyun API to retrieve metadata about fields within a specific entry of an app. The "Entry: Get Fields" operation fetches all field information for a given entry, which is useful when you need to understand the structure or schema of data entries in your Jiandaoyun app.

Common scenarios include:

  • Dynamically generating forms or UI elements based on the fields available in an entry.
  • Validating or mapping data before processing or integration.
  • Automating workflows that depend on the metadata of Jiandaoyun entries.

For example, if you have an app with multiple entries representing different data forms, this operation lets you programmatically obtain the list of fields (like text inputs, dates, dropdowns) for a particular entry ID, enabling flexible automation and integration.

Properties

Name Meaning
App ID The unique identifier of the Jiandaoyun app containing the entry.
Entry ID The unique identifier of the entry within the app whose fields you want to retrieve.

Output

The output JSON contains an array of field objects describing each field in the specified entry. Each field object typically includes properties such as the field's internal name, label, type, and other metadata describing the widget or input type.

This allows downstream nodes or workflows to access detailed information about the entry's fields for further processing.

The node does not output binary data for this operation.

Dependencies

  • Requires an active connection to the Jiandaoyun API via an API key credential configured in n8n.
  • The node uses the Jiandaoyun API endpoint /api/v5/app/entry/widget/list to fetch the field information.
  • Proper permissions on the Jiandaoyun app and entry are necessary to retrieve field metadata.

Troubleshooting

  • Missing or invalid App ID / Entry ID: Ensure that both IDs are correctly provided and correspond to existing resources in Jiandaoyun.
  • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
  • API rate limits or network issues: If requests fail intermittently, check network connectivity and Jiandaoyun API rate limits.
  • Unexpected response structure: If the output does not contain expected fields, confirm that the entry actually has fields defined and that the API version matches the node's expectations.

Common error messages:

  • "Not implemented yet": This indicates an unsupported operation or resource combination was selected.
  • Errors related to JSON parsing or invalid parameters usually mean input values are malformed or missing.

Links and References

Discussion