Domains

Domains können:

  1. über Variomedia registriert,
  2. einer Präsenz zugeordnet (d.h. sie wird bei Variomedia genutzt, aber woanders registriert; auch „externe Domain“ genannt),
  3. beides sein.

Deshalb enthält die Reponse zwei Unterfelder: registration und presence. Je nach Domaintyp, kann eines der beiden Felder null sein, was eine Unterscheidung ermöglicht.


GET /domains

Liefert eine Liste aller Domains mit Erstellungs- und Ablaufdatum.

GET /domains?filter[owner_id]={customer_id}

Liefert eine Liste aller Domains, die dem Kunden mit der Kundennummer {customer_id} gehören. Es ist möglich mehrere Kundennummern anzugeben (entweder getrennt durch ein Komma oder durch mehrfache Angabe von filter.)

GET /domains/{domain-name}

Liefert Details zur Domain {domain-name}.

Manipulation von Domains

PATCH /domains/{domain-name}

Ermöglicht die Manipulation von existierenden Domains. Bitte beachten Sie, dass die Domain in der URL und das id-Feld im Body identisch sein müssen.

DNS-Updateschutz

Den Updateschutz für DNS-Einträge aktiveren, beziehungsweise deaktivieren:

{
    "data": {
        "id": "beispielkunde.info",
        "type": "domain",
        "attributes": {
            "presence": {
                "dns_update_lock": false
            }
        }
    }
}

DNS-Migrationsmodus

Analog können Sie ebenfalls den DNS-Migrationsmodus beeinflussen:

{
    "data": {
        "id": "beispielkunde.info",
        "type": "domain",
        "attributes": {
            "presence": {
                "dns_migration_mode": {
                    "enabled": true
                }
            }
        }
    }
}