Jiandaoyun icon

Jiandaoyun

Consume Jiandaoyun API

Overview

This node interacts with the Jiandaoyun API to retrieve information about apps and their related data entries. Specifically, the "Get Apps" operation under the "App" resource fetches a list of all app information available in the user's Jiandaoyun account.

Common scenarios where this node is beneficial include:

  • Automating workflows that require fetching metadata about apps for reporting or integration purposes.
  • Synchronizing app lists from Jiandaoyun into other systems.
  • Building dashboards or monitoring tools that display app details dynamically.

For example, a user might use this node to periodically retrieve all apps to check which ones are active or to gather app IDs for subsequent operations like fetching entries or data records.

Properties

Name Meaning
App ID The unique identifier of the app (required for some operations but not for "Get Apps").
Entry ID The unique identifier of an entry within an app (not used in "Get Apps").
Return Count The number of records to retrieve in one request; maximum 100, default is 100.
Skip Count The number of records to skip before starting to return results; default is 0.

Note: For the "Get Apps" operation, only Return Count and Skip Count are relevant as it retrieves multiple apps with pagination support.

Output

The output JSON contains an array of app objects returned by the Jiandaoyun API. Each object represents an app with its associated metadata such as app ID, name, description, creation date, and other relevant fields provided by the API.

The node does not output binary data for this operation.

Example output structure (simplified):

[
  {
    "app_id": "123456",
    "name": "Sample App",
    "description": "An example app",
    "created_at": "2023-01-01T00:00:00Z",
    ...
  },
  ...
]

Dependencies

  • Requires an API key credential for authenticating requests to the Jiandaoyun API.
  • The node uses the base URL configured in the credential to send HTTP POST requests.
  • No additional external dependencies beyond the Jiandaoyun API and n8n's built-in HTTP request helpers.

Troubleshooting

  • Error: "Not implemented yet" — This error indicates that the selected resource-operation combination is not supported by the node implementation. Ensure you have selected "App" as the resource and "Get Apps" as the operation.
  • Invalid credentials or authentication errors — Verify that the API key credential is correctly configured and has sufficient permissions.
  • Pagination issues — If you do not receive all expected apps, adjust the Return Count and Skip Count properties to paginate through the full list.
  • Malformed response or parsing errors — These may occur if the API changes or returns unexpected data. Check the API status and update the node if necessary.

Links and References

Discussion