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 integrates with the Ikoula NDD API to manage domain name services, specifically focusing on DNS registrations used for Certbot validation. The "Delete DNS Registration" operation allows users to remove a previously added DNS TXT record that Certbot uses to verify domain ownership during SSL certificate issuance.

Common scenarios include automating the cleanup of DNS validation records after a certificate has been successfully issued or renewed, helping maintain a clean DNS zone and avoiding stale validation entries.

Practical example: After completing a Let's Encrypt certificate renewal process using DNS validation, this node can be used to delete the temporary TXT record created for the domain, ensuring no leftover validation records remain.

Properties

Name Meaning
Certbot Domain The domain name for which the Certbot DNS registration (TXT record) is managed.
Certbot Validation The validation string associated with the Certbot DNS TXT record to identify it uniquely.
Response Format The format in which the API response is returned. Options: JSON, XML.

Output

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

  • For successful deletion, the response typically confirms the removal of the DNS registration.
  • If the response format is JSON, the output is parsed into a JavaScript object.
  • If XML is requested, the raw XML string is included under the data property inside the json field.

No binary data output is produced by this node.

Example output structure (in JSON format):

[
  {
    "json": {
      "status": "success",
      "message": "DNS registration deleted"
    },
    "pairedItem": 0
  }
]

If an error occurs and "Continue On Fail" is enabled, the output will contain an error message like:

{
  "json": {
    "error": "Error message here"
  },
  "pairedItem": 0
}

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 endpoints.
  • No additional external dependencies beyond standard n8n helpers and Node.js crypto module.

Troubleshooting

  • No credentials provided!
    This error occurs if the required API credentials are missing. Ensure you have configured the necessary API authentication details in n8n credentials.

  • Invalid domain or validation string
    If the domain or validation string does not match any existing DNS registration, the API may return an error indicating the resource was not found. Verify the correctness of these inputs.

  • API connectivity issues
    Network problems or incorrect API URLs can cause request failures. Confirm the API endpoint is reachable and correct.

  • Response format errors
    Selecting XML format requires handling XML responses properly downstream. If your workflow expects JSON, use the JSON response format.

  • Continue On Fail behavior
    When enabled, the node will continue processing subsequent items even if one fails, returning error details in the output JSON.

Links and References

Discussion