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 möglich oder über unsere API.


📌 Verwaltung über das Webinterface

Im FameSystems Reseller Webinterface kannst du die Zonen-Einstellungen für jede deiner Kunden-Domains einfach verwalten.
Auf dem Screenshot siehst du die verfügbaren SOA-Felder, die du anpassen kannst:

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 unsere 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-Format):

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

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 API-POST-Request tun.

📤 SOA-Zone setzen (Beispiel)

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 (Erfolgreiche Aktualisierung):

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

❌ Fehlerbehebung

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

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

Falls du weiterhin Probleme hast, kontaktiere unser Support-Team:
📧 Reseller-Support kontaktieren

🚀 Nutze jetzt professionelle DNS-Verwaltung mit FameSystems!