Ikoula Business APIInstall

Overview

This node interacts with the Ikoula Business API to manage business-related operations such as retrieving product categories, listing products within categories, and other business account management tasks. Specifically, the "Get Categories" operation fetches all product categories available in the Ikoula Business system.

Common scenarios for this node include:

• Integrating Ikoula's product catalog into workflows to dynamically retrieve and display product categories.
• Automating business processes that depend on up-to-date category information from Ikoula.
• Using category data to filter or organize subsequent API calls, such as fetching products by category.

Example: A user wants to build a workflow that lists all product categories from their Ikoula business account and then uses those categories to trigger further actions like ordering services or domains.

Properties

Output

The output is an array of items where each item contains a json field holding the API response data.

• For the "Get Categories" operation, the json field contains the list of product categories retrieved from the Ikoula Business API.
• If the response format is JSON, the data is parsed into a JavaScript object.
• If the response format is XML, the raw XML string is returned inside the json.data field.
• The node does not output binary data.

Example output structure (simplified):

[
  {
    "json": {
      "categories": [
        {
          "id": 1,
          "name": "Hosting",
          "description": "Web hosting services"
        },
        {
          "id": 2,
          "name": "Domains",
          "description": "Domain registration services"
        }
      ]
    }
  }
]

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 endpoint (https://api.ikoula.com by default).
• No additional external dependencies beyond standard n8n helpers and Node.js crypto module.

Troubleshooting

• No credentials provided!
  This error occurs if the node is executed without setting up the required API credentials. Ensure you have configured the necessary API authentication details in n8n.

• API request failures
  Network issues, invalid credentials, or incorrect parameters can cause HTTP errors. Verify your credentials, parameter values, and network connectivity.

• Invalid response format
  If you select XML but downstream nodes expect JSON, parsing errors may occur. Choose the response format according to your workflow needs.

• Continue On Fail behavior
  If enabled, the node will return error messages in the output instead of stopping execution, allowing workflows to handle errors gracefully.

Links and References

• Ikoula Business API Documentation (general reference, check for latest official docs)
• n8n Documentation - Creating Nodes
• Node.js Crypto Module (for understanding encryption used)