Ikoula NDD API icon

Ikoula NDD API

Interact with Ikoula NDD API for domain name services and DNS management. Developed by Ascenzia - www.ascenzia.fr
Join our community

Actions4

Overview

This node interacts with the Ikoula NDD API to retrieve details about a specific domain name service (NDD) account subscription. It is useful when you need to programmatically access information about your domain service subscriptions managed by Ikoula, such as billing, status, or configuration details.

A practical example would be automating the retrieval of account details for monitoring or reporting purposes within an n8n workflow, enabling seamless integration with other systems without manual intervention.

Properties

Name Meaning
Subscription ID The unique numeric identifier of the NDD service subscription whose details are requested.
Response Format The format in which the API response should be returned. Options: JSON, XML.

Output

The node outputs the account details in the json field of the output data. The structure depends on the chosen response format:

  • If JSON is selected, the output will be a parsed JSON object containing the account details.
  • If XML is selected, the output will contain the raw XML response as a string under the data property inside the json field.

No binary data is produced by this operation.

Example JSON output snippet (simplified):

{
  "accountId": 12345,
  "status": "active",
  "subscriptionDetails": {
    "domain": "example.com",
    "expiryDate": "2024-12-31"
  }
}

Dependencies

  • Requires valid credentials for the Ikoula 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).
  • Proper API authentication credentials must be configured in n8n prior to use.

Troubleshooting

  • No credentials provided!
    This error occurs if the node cannot find the required API credentials. Ensure that the API key credential is properly set up in n8n.

  • Invalid Subscription ID
    If the subscription ID does not exist or is incorrect, the API may return an error or empty response. Verify the subscription ID value.

  • Response format issues
    Selecting XML format returns raw XML data; ensure downstream nodes can handle XML or convert it accordingly.

  • Network or API errors
    Check network connectivity and API availability. Also verify that the API credentials have sufficient permissions.

  • Encryption errors
    The password is encrypted with a hardcoded RSA public key. If the API changes its key, the node will fail to authenticate.

Links and References

Discussion