Ikoula NDD APIInstall

Overview

The Ikoula NDD API node allows users to interact with the Ikoula domain name service (NDD) and DNS management API. It supports operations such as listing all NDD accounts, retrieving details of a specific account, and managing DNS registrations for certbot validation.

A common use case is automating domain management tasks within workflows, such as fetching domain account lists or programmatically adding/removing DNS TXT records required for SSL certificate validation via certbot.

For example, you can use this node to:

• Retrieve a list of all your domain name service accounts.
• Get detailed information about a particular subscription.
• Add a DNS TXT record to prove domain ownership during SSL certificate issuance.
• Remove the DNS TXT record after validation is complete.

Properties

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output item contains a json field with the API response data:

• For the List Accounts operation, the json field contains the list of NDD accounts retrieved from the API.
• If the response format is XML, the raw XML string is included under json.data.
• For other operations, the output structure varies according to the API response but is always wrapped in the json property.

The node does not output binary data.

Dependencies

• Requires an API key credential for authenticating with the Ikoula API. This includes email, password, and optionally a custom API URL.
• Uses RSA public key encryption to encrypt the password before sending it to the API.
• The node makes HTTP requests to the Ikoula API endpoint (https://api.ikoula.com by default).

Troubleshooting

• No credentials provided!
  This error occurs if the node is executed without valid API credentials configured. Ensure that the required API authentication details are set up correctly in the node's credentials.

• API request failures
  Network issues, invalid credentials, or incorrect parameters may cause the API calls to fail. Check the error message returned by the API for details.

• Incorrect response format
  If the selected response format does not match the expected processing logic downstream, adjust the "Response Format" property accordingly.

• Encryption errors
  The node encrypts the password using a hardcoded RSA public key. If this key changes or becomes invalid, authentication will fail.

Links and References

• Ikoula Official Website
• Ikoula API Documentation (assumed, check actual docs for details)
• n8n Documentation on Creating Nodes