TANSS Domains icon

TANSS Domains

Verwaltet Domains und DNS-Einträge in der TANSS API

Overview

This node manages domains and DNS entries via the TANSS API. It supports creating, retrieving, listing, updating, and deleting domain records. This is useful for automating domain management tasks such as provisioning new domains, updating domain details, or cleaning up unused domains in bulk workflows.

Practical examples:

  • Automatically create a new domain record when onboarding a client.
  • Retrieve domain information to verify status or expiry dates.
  • List all domains managed under an account for reporting.
  • Update domain settings like registrar or auto-renewal status.
  • Delete domains that are no longer needed to keep the system tidy.

Properties

Name Meaning
Operation The action to perform: "Domain erstellen" (create), "Domain abrufen" (get), "Domains auflisten" (list), "Domain aktualisieren" (update), "Domain löschen" (delete)
API Token API token from TANSS authentication used to authorize requests
Domain-ID ID of the domain to get, update, or delete (required for these 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 to enable/disable 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:

  • Create Domain: JSON object with details of the newly created domain.
  • Get Domain: JSON object with detailed information about the specified domain.
  • List Domains: Array of domain objects listing all domains.
  • Update Domain: JSON object with updated domain details.
  • Delete Domain: JSON object confirming deletion or status message.

No binary data output is produced by this node.

Dependencies

  • Requires an API token credential for authenticating with the TANSS API.
  • The base URL for the TANSS API is obtained from the node credentials configuration.
  • Network access to the TANSS API endpoint is necessary.

Troubleshooting

  • Missing Credentials: If no API token credential is found, the node throws an error "Keine Anmeldedaten gefunden!" Ensure the API token is configured correctly.
  • Empty Domain Fields: For create and update operations, if no domain fields are provided, the node throws errors indicating missing fields. Always provide required domain data.
  • Invalid Operation: If an unsupported operation is selected, an error is thrown stating the operation is not recognized.
  • API Request Failures: Errors during HTTP requests 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 provided; otherwise, the request will fail.

Links and References

Discussion