Overview
This node integrates with the TANSS API to manage domains and DNS entries. It allows users to perform common domain management tasks such as creating new domains, retrieving details of a specific domain, listing all domains, updating domain information, and deleting domains.
Typical use cases include automating domain lifecycle management within an organization, synchronizing domain data between systems, or integrating domain operations into broader workflows that require domain status checks or updates.
For example, a user can list all domains managed in TANSS to generate reports, create a new domain entry when onboarding a new project, or update domain expiry dates automatically based on external triggers.
Properties
| Name | Meaning |
|---|---|
| Operation | The action to perform: - Domain erstellen (Create a new domain) - Domain abrufen (Get domain details) - Domains auflisten (List all domains) - Domain aktualisieren (Update domain info) - Domain löschen (Delete a domain) |
| API Token | API token from TANSS authentication used for authorization |
| Domain-ID | ID of the domain (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 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:
- For listDomains, it returns an array of domain objects.
- For getDomain, it returns detailed information about the specified domain.
- For createDomain and updateDomain, it returns the created or updated domain object.
- For deleteDomain, it returns confirmation of deletion or related status.
No binary data output is produced by this node.
Dependencies
- Requires access to the TANSS API endpoint, configured via credentials containing the base URL and an API key/token.
- The user must provide a valid API token for each execution.
- Network connectivity to the TANSS backend API is necessary.
Troubleshooting
- Missing Credentials Error: If no credentials are found, the node throws "Keine Anmeldedaten gefunden!" Ensure that the required API credentials are properly set up in n8n.
- Empty Domain Fields: When creating or updating a domain, if no domain fields are provided, the node throws errors indicating missing fields. Always specify at least one domain field for these operations.
- Invalid Operation: If an unsupported operation is selected, the node will throw an error stating the operation is not recognized.
- API Request Failures: Errors during API calls return messages like "Fehler beim Ausführen von [operation]: [error message]". Check the API token validity, network connection, and API endpoint accessibility.
- Domain ID Required: For operations that require a domain ID (get, update, delete), ensure a valid numeric domain ID is provided.
Links and References
- TANSS API Documentation (not provided here; refer to your organization's internal API docs)
- 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/