Ikoula Business APIInstall

Overview

This node integrates with the Ikoula Business API to manage business-related operations, specifically focusing on product categories and their products. The "Get Category Products" operation retrieves a list of products within a specified product category. This is useful for scenarios where you want to dynamically fetch and display available products under a certain category from your Ikoula business account, such as in e-commerce platforms, inventory management systems, or automated reporting workflows.

Practical example:
You have an online store powered by Ikoula services and want to automatically update your product listings based on categories. Using this node, you can fetch all products under a specific category ID and use that data downstream to update your website or notify your sales team.

Properties

Output

The node outputs an array of items, each containing a json property with the API response data:

• When the response format is JSON, the json field contains the parsed JSON object representing the category products.
• When the response format is XML, the json field contains the raw XML string under a data property.

The output structure corresponds directly to the API's response for the category products endpoint, typically including product details such as IDs, names, descriptions, prices, and other relevant attributes.

No binary data output is produced by this operation.

Dependencies

• Requires valid credentials for the Ikoula Business API, including email, password, and optionally a custom API URL.
• The password is encrypted using RSA public key encryption before being sent.
• The node makes HTTP requests to the Ikoula API endpoints.
• No additional external dependencies beyond standard n8n HTTP request helpers.

Troubleshooting

• No credentials provided!
  This error occurs if the node is executed without proper API credentials configured. Ensure you have set up the required API authentication token or credentials in n8n.

• Invalid Category ID or no products returned
  If the category ID does not exist or has no products, the API may return an empty list or an error. Verify the category ID is correct and exists in your Ikoula account.

• API response format issues
  Selecting XML format returns raw XML data as a string. Downstream nodes expecting JSON will need to parse this manually.

• Network or API errors
  Any HTTP or network errors during the request will be thrown unless "Continue On Fail" is enabled, in which case the error message will be included in the output item.

Links and References

• Ikoula Business API Documentation (official API docs, check for latest endpoints and parameters)
• n8n HTTP Request Node Documentation (for understanding HTTP request handling in n8n)