iTwin Component Center icon

iTwin Component Center

Comprehensive iTwin Component Center API

Actions58

Overview

This node interacts with the iTwin Component Center API to retrieve information about applications. Specifically, the "Get Applications" operation fetches a list of applications from the service. It supports pagination through a continuation token, allowing users to retrieve results in batches (typically 50 per request). This is useful when dealing with large sets of application data that cannot be fetched all at once.

Practical examples include:

  • Fetching all registered applications in an iTwin environment for auditing or reporting.
  • Incrementally loading applications page by page using the continuation token to avoid timeouts or memory issues.
  • Integrating application data into workflows for further processing or automation.

Properties

Name Meaning
Continuation Token A string token used for pagination. The API returns up to 50 results per call along with a link containing a continuation token for the next page. Provide this token to fetch subsequent pages. If no more results exist, no token is returned.

Output

The node outputs JSON data representing the applications retrieved from the iTwin Component Center API. Each item corresponds to an application object as returned by the API. The output is structured as an array of JSON objects, each containing details about an individual application.

No binary data output is indicated.

Dependencies

  • Requires an API authentication credential (OAuth2) configured in n8n to access the iTwin Component Center API.
  • The node depends on the bundled ComponentCenterOpenApiInterpreter module to interpret and execute API operations.
  • Network connectivity to the iTwin Component Center API endpoint is necessary.

Troubleshooting

  • Common Issues:

    • Missing or invalid API credentials will cause authentication failures.
    • Providing an incorrect or expired continuation token may result in empty responses or errors.
    • Network issues can prevent successful API calls.

  • Error Messages:

    • "Unknown operation: get-applications": Indicates the operation name was not recognized; ensure the operation parameter is correctly set.
    • Errors related to API authentication typically indicate misconfigured or missing credentials.
    • If the node fails but "Continue On Fail" is enabled, error details are included in the output JSON under an error field.

  • Resolutions:

    • Verify that the API key or OAuth2 credentials are properly set up in n8n.
    • Use the continuation token exactly as returned by the previous response without modification.
    • Check network connectivity and API availability.

Links and References

Discussion