Overview
This node integrates with the TANSS API to manage domain names and DNS entries. It supports creating, retrieving, listing, updating, and deleting domains within the TANSS system. This is useful for automating domain management tasks such as registering new domains, updating domain details, 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 in TANSS for reporting purposes.
- Updating domain status or expiry dates based on external triggers.
- Deleting domains that are no longer needed.
Properties
| Name | Meaning |
|---|---|
| API Token | API token from TANSS authentication used to authorize requests. |
| Domain-Felder | Collection of fields describing the domain. Includes: |
| - Domain-Name: The domain name (e.g., example.com). | |
| - Unternehmen-ID: ID of the associated company. | |
| - Registrar: Domain registrar name. | |
| - Ablaufdatum: Expiry date of the domain. | |
| - Nameserver: Comma-separated list of nameservers. | |
| - Status: Domain status; options are Aktiv (ACTIVE), Inaktiv (INACTIVE), Abgelaufen (EXPIRED), Gesperrt (LOCKED). | |
| - Auto-Renewal: Boolean indicating if auto-renewal is enabled. | |
| Domain-ID | Numeric ID of the domain, required for get, update, and delete operations. |
| Operation | The action to perform: createDomain, getDomain, listDomains, updateDomain, deleteDomain. |
Output
The node outputs JSON data representing the response from the TANSS API for each executed operation. The structure depends on the operation:
- createDomain: JSON object with details of the newly created domain.
- getDomain: JSON object containing information about the specified domain.
- listDomains: Array of domain objects listing all domains.
- updateDomain: JSON object with updated domain details.
- deleteDomain: JSON confirmation or status of the deletion.
No binary data output is produced by this node.
Dependencies
- Requires an active TANSS API credential with a valid API token.
- The node expects the base URL of the TANSS API to be provided via credentials.
- Network access to the TANSS API endpoint is necessary.
Troubleshooting
- Missing Credentials: If no API credentials are found, the node throws an error "Keine Anmeldedaten gefunden!" Ensure the API token credential is configured correctly.
- Empty Domain Fields: For create and update operations, if no domain fields are provided, the node throws errors like "Keine Felder für die Domain-Erstellung angegeben." or "Keine Felder zum Aktualisieren angegeben." Always provide at least one field when creating or updating.
- Invalid Operation: If an unsupported operation is selected, the node will throw an error indicating the operation is not recognized.
- API Request Failures: Errors during HTTP requests return messages prefixed with "Fehler beim Ausführen von [operation]:". Check network connectivity, API token validity, and request parameters.
Links and References
- TANSS API Documentation (not provided here, but users should refer to their official TANSS API docs)
- n8n Documentation on Creating Custom Nodes: https://docs.n8n.io/integrations/creating-nodes/