Ikoula API CS
Overview
This node interacts with the Ikoula CloudStack API to retrieve billing-related information for a given subscription. Specifically, the "Get Billing Grid" operation fetches a detailed billing grid associated with a subscription ID. This is useful for users who want to programmatically access structured billing data such as usage details, costs, or invoice breakdowns from their Ikoula cloud account.
Common scenarios:
- Automating retrieval of billing details for financial reporting.
- Integrating Ikoula billing data into dashboards or accounting systems.
- Monitoring and auditing cloud resource consumption and costs.
Example:
A user wants to get the billing grid for subscription ID 12345 in JSON format to analyze monthly charges and usage patterns automatically.
Properties
| Name | Meaning |
|---|---|
| Subscription ID | The unique numeric identifier of the subscription for which the billing grid is retrieved. |
| Response Format | The format of the API response. Options: JSON (default) or XML. |
Output
The node outputs an array of items where each item contains a json property holding the API response data.
- If the response format is JSON, the
jsonfield contains the parsed JSON object representing the billing grid. - If the response format is XML, the
jsonfield contains the raw XML string under adataproperty.
No binary data output is produced by this node.
Dependencies
- Requires valid credentials for the Ikoula API, including email, password, and optionally a custom API URL.
- Uses RSA public key encryption to encrypt the password before sending it to the API.
- Makes HTTP GET requests to the Ikoula API endpoints.
- Requires the node to be configured with an API authentication credential (an API key or similar).
Troubleshooting
No credentials provided!
Error thrown if the node is executed without proper API credentials configured. Ensure that the required API authentication token or credentials are set up in n8n.HTTP request failures:
Network issues, invalid subscription IDs, or incorrect API URLs can cause request errors. Verify the subscription ID is correct and the API endpoint is reachable.Response format issues:
If XML is selected but downstream nodes expect JSON, parsing errors may occur. Choose the response format according to your workflow needs.Encryption errors:
The node uses RSA encryption for the password; any modification or corruption of the public key could cause authentication failures.
Links and References
- Ikoula CloudStack API Documentation (general reference for API endpoints and parameters)
- n8n HTTP Request Node Documentation (for understanding HTTP request options)
If you need further details on other operations or resources, feel free to ask!