Overview
This node integrates with the TANSS API to manage domains and DNS entries. It supports creating, retrieving, listing, updating, and deleting domain records via the API. This is useful for automating domain management tasks such as provisioning new domains, fetching domain details, maintaining domain information, or cleaning up unused domains.
Practical examples include:
- Automatically creating a new domain record when onboarding a client.
- Fetching domain details to synchronize with an internal database.
- Listing all domains managed under an account for reporting.
- Updating domain status or nameservers based on external triggers.
- Deleting expired or unwanted domains programmatically.
Properties
| Name | Meaning |
|---|---|
| Operation | The action to perform: Domain erstellen (createDomain), Domain abrufen (getDomain), Domains auflisten (listDomains), Domain aktualisieren (updateDomain), Domain löschen (deleteDomain) |
| API Token | API token from TANSS authentication used to authorize requests |
| Domain-ID | ID of the domain to retrieve, update, or delete (required for getDomain, updateDomain, deleteDomain operations) |
| Domain-Felder (Domain Fields) | Collection of domain properties used when creating or updating a domain: - Domain-Name: Domain name (e.g., example.com) - Unternehmen-ID: Company ID associated with the domain - Registrar: Domain registrar name - Ablaufdatum: Expiry date of the domain - Nameserver: Comma-separated list of nameservers - Status: Domain status ( Aktiv, Inaktiv, Abgelaufen, Gesperrt)- Auto-Renewal: Boolean flag for automatic renewal |
Output
The node outputs JSON data representing the response from the TANSS API for each executed operation. The structure depends on the operation:
- For createDomain: JSON object with details of the newly created domain.
- For getDomain: JSON object containing the domain's information.
- For listDomains: JSON array of domain objects.
- For updateDomain: JSON object with updated domain details.
- For deleteDomain: JSON object confirming deletion or status.
No binary data output is produced by this node.
Dependencies
- Requires an active TANSS API credential with a valid base URL and API token.
- The API token must be provided as an input property for each execution.
- Network access to the TANSS API endpoint is necessary.
Troubleshooting
- Missing Credentials Error: If no credentials are found, the node throws "Keine Anmeldedaten gefunden!" Ensure that the TANSS API credential is configured correctly in n8n.
- Empty Fields for Create/Update: When creating or updating a domain, if no domain fields are provided, the node throws an error indicating missing fields. Always provide at least one field in the "Domain-Felder" collection.
- Unknown Operation: If an unsupported operation is selected, the node will throw an error specifying the unrecognized operation.
- API Request Failures: Errors during API calls return messages like "Fehler beim Ausführen von [operation]: [error message]". Check the API token validity, network connectivity, and correct domain IDs.
- Domain-ID Required: For operations that require a domain ID (get, update, delete), ensure a valid numeric ID is provided; otherwise, the request will fail.
Links and References
- TANSS API Documentation (not included in source; consult your TANSS API provider)
- n8n Documentation on Creating Custom Nodes: https://docs.n8n.io/integrations/creating-nodes/
- General REST API usage in n8n: https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httpRequest/