Ajax icon

Ajax

Consume Ajax API (v.0.1.2)

Actions242

Overview

This node, named "Ajax," is designed to interact with a specific Ajax API (version indicated in the code). It supports multiple resources and operations, including the "Ring Management" resource with the "Get Hub's Buses" operation. The node fetches data from the Ajax backend by making HTTP requests authenticated via an API key credential.

A common use case for this node is to retrieve detailed information about buses associated with a particular hub within a company’s ring management system. For example, a user might want to get all bus devices connected to a specific hub to monitor their status or perform further automation based on that data.

Properties

Name Meaning
Company Id The unique identifier of the company owning the hub. Required to specify the company context.
Hub Id The unique identifier of the hub whose buses are to be retrieved. Required to specify the target hub.

These properties must be provided when selecting the "Ring Management" resource and the "Get Hub's Buses" operation.

Output

The node outputs JSON data representing the list of buses associated with the specified hub. The exact structure depends on the API response but typically includes details such as bus identifiers, statuses, and related metadata.

If the node supports binary data output, it would represent any binary content returned by the API; however, based on the static analysis, this operation primarily returns JSON data.

Dependencies

  • Requires an API key credential to authenticate requests against the Ajax backend API.
  • Relies on internal HTTP client utilities to perform REST calls.
  • The node uses a versioned API endpoint (version referenced in the code) and expects the environment to have network access to the Ajax API service.

Troubleshooting

  • Missing or invalid credentials: If the API key is not set or invalid, the node will fail authentication. Ensure the API key credential is correctly configured.
  • Invalid Company Id or Hub Id: Providing incorrect or non-existent IDs will result in errors or empty responses. Verify these IDs before execution.
  • Network issues: Connectivity problems to the Ajax API endpoint can cause timeouts or failures.
  • API changes: Since the node relies on a specific API version, updates or deprecations in the backend API may cause unexpected errors.

Common error messages likely relate to authentication failures, resource not found, or malformed requests. Checking the input parameters and credentials usually resolves these issues.

Links and References

Discussion