Items - UNEXO icon

Items - UNEXO

Node for Items

Overview

This node, named "Items - UNEXO," is designed to fetch and filter items from an external service using a customizable JSON filter condition. It sends a POST request with the specified filter to retrieve matching items. This node is useful in scenarios where you need to dynamically query and process item data based on specific criteria, such as filtering consumable products or other attributes.

Practical examples include:

  • Retrieving all consumable items from an inventory system.
  • Fetching items that meet certain custom conditions defined by the user in JSON format.
  • Integrating filtered item data into workflows for further processing or reporting.

Properties

Name Meaning
Items Filter Condition JSON string defining filter conditions to fetch items. Example: { "isConsumable": true }

Output

The node outputs an array of items matching the filter condition. Each output item contains a json field with a response property holding the individual item data returned from the external API.

Output structure example:

[
  {
    "json": {
      "response": {
        // Item properties as returned by the API
      }
    }
  },
  ...
]

No binary data output is produced by this node.

Dependencies

  • Requires an environment variable CDP_URL specifying the base URL of the external API.
  • Requires an environment variable UNEXO_API_KEY containing a valid API authentication token.
  • The node makes an HTTP POST request to the endpoint /api/items/getFilteredItems on the configured API server.

Troubleshooting

  • Common issues:

    • Missing or incorrect environment variables (CDP_URL or UNEXO_API_KEY) will cause authentication or connection failures.
    • Malformed JSON in the "Items Filter Condition" property may lead to request errors or unexpected results.
    • Network connectivity problems can prevent successful API calls.

  • Error messages and resolutions:

    • Authentication errors (e.g., 401 Unauthorized): Verify that the API key environment variable is correctly set and valid.
    • Request failures due to invalid JSON: Ensure the filter condition is a properly formatted JSON string.
    • Timeout or network errors: Check network connectivity and API server availability.

Links and References

  • No direct links provided in the source code. For more information, consult the documentation of the external API at the URL specified by CDP_URL.

Discussion