Skip to content

DNS SOA-Zonenverwaltung

Jede Domain verfügt über eine Start of Authority (SOA) Zone, die wichtige Konfigurationswerte für DNS-Server enthält. Die Verwaltung der SOA-Zone ist im FameSystems Reseller Webinterface oder über die API möglich.

Verwaltung über das Webinterface

Im Reseller Webinterface kannst du die Zonen-Einstellungen für jede deiner Kunden-Domains verwalten.

DNS Zone im FameSystems Webinterface

  • Refresh -- Gibt an, wie oft sekundäre Nameserver die Zone aktualisieren sollen.
  • Retry -- Zeitintervall für den erneuten Versuch einer Aktualisierung, falls der erste Versuch fehlschlägt.
  • Expire -- Zeitraum, nach dem sekundäre Nameserver die Zone als ungültig betrachten, falls kein Update erfolgte.
  • TTL (Time to Live) -- Lebensdauer eines DNS-Eintrags, bevor dieser erneut abgefragt wird.
  • Admin E-Mail -- Kontaktadresse für den Zonenadministrator.

Änderungen können direkt über das Interface gespeichert werden.

Verwaltung über die API

Alternativ kannst du die SOA-Zonendaten programmgesteuert über die API abrufen und ändern.

SOA-Zone abrufen (GET /domain/zone)

Du kannst die aktuellen SOA-Werte einer Domain mit folgendem API-Request abrufen:

Anfrage:

curl -X GET "https://v2.resellerapi.de/domain/zone?domain=example.com"   -H "Authorization: Bearer DEIN_API_KEY"   -H "Accept: application/json"

Antwort (JSON):

{
  "primary_dns": "ns1.famesystems.de.",
  "admin_email": "[email protected]",
  "serial": "1741626978",
  "refresh": 10000,
  "retry": 2400,
  "expire": 604800,
  "minimum_ttl": 3600
}

Fehlerbehandlung

Falls die Domain nicht gefunden wird oder fehlerhafte Parameter übergeben werden, gibt die API den HTTP-Statuscode 400 oder 500 zurück.

SOA-Zone setzen (POST /domain/zone)

Falls du Änderungen an den SOA-Werten vornehmen möchtest, kannst du dies mit einem POST-Request tun.

Anfrage:

curl -X POST "https://v2.resellerapi.de/domain/zone"   -H "Authorization: Bearer DEIN_API_KEY"   -H "Content-Type: application/x-www-form-urlencoded"   -d "domain=example.com"   -d "refresh=12000"   -d "retry=3000"   -d "expire=800000"   -d "minimum_ttl=4000"   -d "[email protected]"

Antwort (Erfolg):

{
  "status": "success",
  "message": "DNS-Zone wurde erfolgreich aktualisiert."
}

Fehlerbehebung

Falls du einen Fehlercode wie 400 oder 500 erhältst, prüfe Folgendes:

  • Ist die Domain korrekt registriert?
  • Hast du einen gültigen API-Token verwendet?
  • Stimmen die Werte für Refresh, Retry, Expire und TTL?

Bei Fragen erreichst du den Support unter +49 9901 8799495.