Fractal Forge icon

Fractal Forge

Retrieve data from FractalForge API

Actions9

Overview

This node integrates with the FractalForge API to retrieve data from specified entity collections. Specifically, the Query - Get operation fetches a single object by its ID from a chosen entity collection. This is useful when you need to obtain detailed information about a specific record within a collection.

Common scenarios:

  • Fetching user details by user ID.
  • Retrieving a specific order or transaction record.
  • Accessing configuration or metadata objects stored in FractalForge.

Practical example:
You want to get the details of a customer with a known unique identifier from the "customers" collection. By selecting the "Query" resource and "Get" operation, specifying the "customers" collection and the customer's ID, the node will return the full JSON representation of that customer.

Properties

Name Meaning
Entity Collection Name or ID Select the target entity collection from which to retrieve the object. Options are dynamically loaded from FractalForge. You can also specify an ID using an expression.
Object ID The unique identifier of the object to retrieve within the selected collection. Must be provided as a string (e.g., UUID).

Output

The output is a JSON array where each item corresponds to the retrieved object from the FractalForge API. The json field contains the full data of the requested object as returned by the API.

No binary data output is produced by this operation.

Example output structure:

[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "Example Object",
    "createdAt": "2024-01-01T12:00:00Z",
    "attributes": {
      "key1": "value1",
      "key2": "value2"
    }
  }
]

Dependencies

  • Requires an API key credential for authenticating with the FractalForge API.
  • The node uses the configured API endpoint and authorization token to make HTTP requests.
  • The "Entity Collection Name or ID" options are dynamically loaded via an authenticated request to the FractalForge system endpoint.

Troubleshooting

  • Error: "The operation 'get' is not known!"
    This indicates the operation parameter was set incorrectly or the resource-operation combination is unsupported. Verify that the resource is set to "Query" and operation to "Get".

  • Authentication errors (e.g., 401 Unauthorized)
    Ensure the API key credential is correctly configured and has sufficient permissions.

  • Object not found or 404 errors
    Confirm that the specified Object ID exists in the selected collection.

  • Network or timeout issues
    Check network connectivity and the availability of the FractalForge API endpoint.

  • Invalid JSON response or parsing errors
    Usually caused by unexpected API responses; verify the API endpoint URL and credentials.

Links and References

Discussion