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 unused 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. Includes: - 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:
- createDomain: JSON object with details of the newly created domain.
- getDomain: JSON object containing detailed information about the specified domain.
- listDomains: JSON array listing all domains accessible by the API token.
- updateDomain: JSON object with updated domain information.
- deleteDomain: JSON object confirming deletion or status message.
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 node expects the API token to be provided as an input property.
- Network access to the TANSS API endpoint is necessary.
- No additional external libraries beyond n8n's standard HTTP request helpers are required.
Troubleshooting
- Missing Credentials: If no credentials are found, the node throws an error "Keine Anmeldedaten gefunden!" Ensure that the API credential is configured correctly in n8n.
- Empty Domain Fields: For create and update operations, if no domain fields are provided, the node throws errors indicating missing fields. Always provide at least one field when creating or updating.
- 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 network connectivity, API token validity, and correct domain IDs.
- Domain-ID Required: For get, update, and delete operations, ensure a valid domain ID is supplied; otherwise, the API call will fail.
Links and References
- TANSS API Documentation (refer to your provider’s official docs for detailed API endpoints and payloads)
- n8n HTTP Request Node documentation for understanding request options and error handling: https://docs.n8n.io/nodes/n8n-nodes-base.httpRequest/