Domains

Domain-Verfügbarkeit prüfen

Prüft, ob Ihre Wunschdomains noch verfügbar sind. Sie können bis zu 30 Domains in einer einzigen Anfrage prüfen. Gibt den Status (Available, NotAvailable, Premium usw.) sowie Preisinformationen zurück.

URL: POST /api/v1/organizations/{organizationId}/domains/availability

Anfrage-Text (Request Body):

{
  "domainNames": ["ihre-wunschdomain.de", "beispiel.at"]
}

Beispiel-Antwort (200 OK):

[
  {
    "domainName": "ihre-wunschdomain.de",
    "availability": "Available",
    "price": 12.5,
    "setupServicePrice": 0.0,
    "isAvailableForRealTimeOrder": true
  }
]

Domain bestellen

Gibt eine verbindliche Bestellung für eine Domain auf. Wichtig: Sie benötigen eine gültige contactHandleId und nameserverSetId.

URL: POST /api/v1/organizations/{organizationId}/domains

Anfrage-Body:

{
  "domainName": "ihre-wunschdomain.de",
  "contactHandleId": "e40695fd-b244-4544-bf5f-afd1745a3e5d",
  "nameserverSetId": "2e7fcfc8-ea2b-466b-8fda-b3d0770452fd",
  "isTrusteeServiceOrdered": false,
  "isIcpServiceOrdered": false,
  "isTermsConditionsAccepted": true
}

Beispiel-Antwort (200 OK):

{
  "domainId": "e6836361-98e3-45c4-9706-c5519b10f27c",
  "domainName": "ihre-wunschdomain.de",
  "status": "requested",
  "orderDate": "2026-01-28T09:30Z"
}

Domains abrufen

Listet alle Domains auf, die zu Ihrer Organisation gehören.

URL: GET /api/v1/organizations/{organizationId}/domains

Beispiel-Antwort (200 OK):

[
  {
    "domainId": "e6836361-98e3-45c4-9706-c5519b10f27c",
    "domainName": "domain.de",
    "status": "active",
    "registrationDate": "2025-05-10T09:30Z"
  }
]

Domain-WHOIS abrufen

Ruft die Registrierungsdaten ab. Es gibt zwei Varianten:

1. Eigene Domain: Details über ID (GET /api/v1/organizations/{organizationId}/domains/{domainId}/public-whois).
2. Beliebige Domain: Suche über Name (GET /api/v1/organizations/{organizationId}/domains/public-whois?domainName=stackit.de).

Beispiel-Antwort (200 OK):

{
  "domainName": "stackit.de",
  "host": "whois.denic.de",
  "whoIsInformation": "Domain: stackit.de\nStatus: connect\nChanged: 2025-04-07T12:17:41+02:00"
}

Domain Status Values

• active: Die Domain ist erfolgreich registriert und aktiv.
• requested: Der Registrierungsprozess wurde eingeleitet.
• pending: Eine manuelle Bearbeitung durch das Registry-Team ist erforderlich.