Domains per API verwalten

Alle Domains auflisten

Bash

curl -X GET \
  https://www.waerner-techservices.de/api/domains \
  -H "Authorization: Bearer $TOKEN"

Response:

JSON

{
  "success": true,
  "domains": [
    {
      "name": "familie-waerner.de",
      "status": "active",
      "expire": "2026-11-02",
      "auto_renew": true,
      "nameservers": ["ns1.wts-hosting.de", "ns2.wts-hosting.de"]
    }
  ]
}

Details einer Domain

Bash

curl -X GET \
  https://www.waerner-techservices.de/api/domains/familie-waerner.de \
  -H "Authorization: Bearer $TOKEN"

DNS-Records lesen

Bash

curl -X GET \
  https://www.waerner-techservices.de/api/domains/familie-waerner.de/dns \
  -H "Authorization: Bearer $TOKEN"

DNS-Record hinzufügen

Bash

curl -X POST \
  https://www.waerner-techservices.de/api/domains/familie-waerner.de/dns \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "A",
    "name": "server",
    "value": "77.90.60.191",
    "ttl": 3600
  }'

Response: HTTP 201 mit ID des neuen Records.

DNS-Record bearbeiten

Bash

curl -X PATCH \
  https://www.waerner-techservices.de/api/domains/familie-waerner.de/dns/12345 \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "value": "77.90.60.192" }'

DNS-Record löschen

Bash

curl -X DELETE \
  https://www.waerner-techservices.de/api/domains/familie-waerner.de/dns/12345 \
  -H "Authorization: Bearer $TOKEN"

Nameserver ändern

Bash

curl -X PATCH \
  https://www.waerner-techservices.de/api/domains/familie-waerner.de/nameservers \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "nameservers": [
      "ns1.cloudflare.com",
      "ns2.cloudflare.com"
    ]
  }'

Auto-Renewal togglen

Bash

curl -X PATCH \
  https://www.waerner-techservices.de/api/domains/familie-waerner.de/autorenew \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "autoRenew": false }'

Bulk-Operations

Wenn Sie viele Domains gleichzeitig ändern wollen:

Bash

curl -X POST \
  https://www.waerner-techservices.de/api/domains/bulk-update \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "domains": ["a.de", "b.de", "c.de"],
    "action": "enable_autorenew"
  }'

Rückgabe zeigt pro Domain Erfolg/Fehler.

Praxis-Beispiel: DNS-Sync-Script

Bash

#!/bin/bash
# Setzt A-Record von "www" auf aktuelle externe IP
DOMAIN="familie-waerner.de"
CURRENT_IP=$(curl -s https://ifconfig.me/)

RECORD_ID=$(curl -s -H "Authorization: Bearer $TOKEN" \
  "https://www.waerner-techservices.de/api/domains/$DOMAIN/dns?name=www&type=A" \
  | jq -r '.records[0].id')

curl -X PATCH \
  "https://www.waerner-techservices.de/api/domains/$DOMAIN/dns/$RECORD_ID" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{ \"value\": \"$CURRENT_IP\" }"

Als Cronjob alle 5 Min → simples DynDNS.

Rate-Limits speziell für DNS

Sehr häufige DNS-Änderungen können bei der DENIC ein Rate-Limit auslösen (max. 100/h pro Domain). Wenn Sie das erreichst, gibt's HTTP 429.

Hat Ihnen diese Anleitung geholfen?

Alle Domains auflisten

Details einer Domain

DNS-Records lesen

DNS-Record hinzufügen

DNS-Record bearbeiten

DNS-Record löschen

Nameserver ändern

Auto-Renewal togglen

Bulk-Operations

Praxis-Beispiel: DNS-Sync-Script

Rate-Limits speziell für DNS

Passend dazu.