Häufig gestellte Fragen zur NiceNIC Domain-API v2

NiceNIC Domain-API v2 ist eine HTTPS- und JSON-basierte API zur Automatisierung der Domainverwaltung über Ihr NiceNIC-Konto.

Sie unterstützt zentrale Arbeitsabläufe wie Domain-Verfügbarkeitsprüfungen, Registrierung, Verlängerung, Transfer, Portfolio-Abfragen, Nameserver- und Kontaktaktualisierungen, Preisabfragen, DNS-Einträge, Child-Nameserver, Kontoinformationen und compliancebezogene Vorgänge.

Verwenden Sie die API, wenn Sie NiceNIC-Domain-Dienste direkt an eine Website, Hosting-Plattform, ein Abrechnungssystem, ein internes Tool oder eine andere Anwendung anbinden möchten.

Jedes aktive NiceNIC-Konto kann die Domain-API v2 nutzen. Der API-Zugang steht sowohl für Standardkundenkonten als auch für Reseller-Konten zur Verfügung.

Sie müssen kein Reseller werden, nur um API-Zugriff zu erhalten. Der Kontotyp ist jedoch weiterhin für die Preisgestaltung relevant: Für kostenpflichtige API-Vorgänge gelten die Preise, die dem anfragenden NiceNIC-Konto zugewiesen sind.

API-Einstellungen öffnen →

Ja. Der API-Zugang selbst ist kostenlos. Es fallen keine gesonderten Gebühren für die Aktivierung des API-Zugangs oder das Senden unterstützter API-Anfragen an.

Kostenpflichtige Vorgänge wie Domainregistrierung, -verlängerung und -transfer werden gemäß den Preisen Ihres Kontos und den geltenden Domain-Regeln abgerechnet.

Nein. API-Zugriff und Reseller-Preise sind voneinander unabhängig.

Sie können die Domain-API v2 mit einem regulären NiceNIC-Endkundenkonto nutzen. Wechseln Sie nur dann zu einem Reseller-Konto, wenn Reseller-Preise oder andere Reseller-Vorteile für Ihr Geschäftsvolumen von Nutzen sind.

Reseller-Tarife vergleichen →

Die Domain-API v2 nutzt die aktuelle NiceNIC-API-Struktur mit HTTPS-Anfragen, JSON-Antworten, Header-basierter Authentifizierung und einer Dokumentation, die nach einzelnen Domain- und Account-Workflows gegliedert ist.

Falls Sie eine Integration betreiben, die auf einer älteren NiceNIC-API basiert, prüfen Sie die Parameter und die Antwortverarbeitung der API v2 vor der Migration des Produktivdatenverkehrs, anstatt davon auszugehen, dass beide Versionen austauschbar sind.

Melden Sie sich bei Ihrem NiceNIC-Konto an und öffnen Sie die API-Einstellungen. API v2-Anfragen verwenden Ihren NiceNIC-Benutzernamen und Ihr API-Secret zur Authentifizierung.

API-Einstellungen öffnen →

Ja. NiceNIC stellt Entwicklern eine API-Testumgebung zur Verfügung, um Integrationen vor der Anbindung an die Produktiv-API zu testen.

Nutzen Sie die Testumgebung, um Authentifizierung, Anfrageformatierung, Antwortverarbeitung, Fehlerbehandlung und Ihre Anwendungsabläufe zu validieren, bevor Sie Domain-Operationen für Live-Kunden aktivieren.

API-Testumgebung öffnen →

Die API-Testumgebung ist für die Entwicklungs- und Integrationsphase vorgesehen. Die Produktions-API wird für produktive Domainvorgänge und kostenpflichtige Anfragen über Ihr NiceNIC-Konto genutzt.

Wir empfehlen, Authentifizierung, Anfragenverarbeitung, Antwortverarbeitung und Fehlerlogik in der Testumgebung zu validieren, bevor Sie kundenorientierte Produktivoperationen aktivieren.

Senden Sie API-Anfragen über HTTPS und fügen Sie Ihren NiceNIC-Benutzernamen und Ihr API-Secret in den Authorization-Header ein.

Host: api.nicenic.net
Authorization: username:api_secret
Content-Type: application/json

Wenn für Ihr Konto IP-Beschränkungen aktiviert sind, müssen Anfragen zudem von einer autorisierten Server-IP stammen.

API-Authentifizierung lesen →

Der Basis-Endpunkt der Produktions-API lautet:

https://api.nicenic.net/v2/

API-Aktionen werden über die für jeden Endpunkt dokumentierten Parameter ausgewählt, wie etwa category und action. Beachten Sie stets die Dokumentation des jeweiligen Endpunkts für die erforderlichen und optionalen Parameter einer bestimmten Operation.

API v2-Antworten verwenden JSON, und Anfrageparameter nutzen UTF-8.

{
  "code": 0,
  "msg": "success",
  "data": {}
}

Ihre Anwendung sollte die zurückgegebenen Werte code und msg auswerten, anstatt davon auszugehen, dass jede HTTP-Antwort einen abgeschlossenen Domain-Vorgang darstellt.

Über die derzeit dokumentierten APIs können Sie Arbeitsabläufe automatisieren, darunter Abfragen zur Domain-Verfügbarkeit, Registrierung, Verlängerung und Transfer, Portfolioauflistung und Domaindetails, Aktualisierungen von Nameservern und Domainkontakten, Domainpreise, DNS-Einträge, Child-Nameserver, Kontoinformationen sowie Abuse- und Compliance-Überwachung.

Weitere Arbeitsabläufe sind einzeln in der API-Navigation dokumentiert.

Beginnen Sie mit risikoarmen Leseoperationen wie Domain-Verfügbarkeit, Domain-Preisen, Kontostand und Domain-Auflistung.

Prüfen Sie anschließend Authentifizierung, Antwortverarbeitung, Fehlerbehandlung und den Umgang mit ausstehenden Aufträgen, bevor Sie Live-Registrierungen, Verlängerungen oder Transfers aktivieren.

Ja. Der Endpunkt Domain-Verfügbarkeit prüfen unterstützt mehrere kommagetrennte Domainnamen.

example.com,example.net,example.org

Gehen Sie nicht davon aus, dass jede API-Operation dasselbe Eingabeformat für mehrere Domains unterstützt. Registrierung, Verlängerung und Transfer sollten der Dokumentation des jeweiligen Endpunkts folgen.

Verwenden Sie den Endpunkt Domain-Preise abrufen. Zu den dokumentierten Preistypen gehören register, renew, transfer und all.

Registrierungsantworten können auch einen Wert is_premium enthalten, der angibt, ob es sich bei der abgefragten Registrierung um eine Premium-Domain handelt.

Da API-Aufträge die Preise auf Kontoebene nutzen, sollten Sie vor dem Absenden kostenpflichtiger Kundenaufträge die aktuellen Preise abfragen, anstatt sich dauerhaft auf zwischengespeicherte Preise zu verlassen.

Nein. Obwohl die API-Dokumentation für berechtigte Endungen Zeiträume von bis zu 1–10 Jahren unterstützt, können für einzelne TLDs abweichende Registry-Regeln gelten.

Registrierungszeiträume, Verlängerungszeiträume, Transferberechtigung, Kontaktanforderungen und Verifizierungsanforderungen können sich je nach Endung unterscheiden. Ihre Anwendung sollte die aktuellen Regeln der jeweiligen TLD befolgen.

Hierbei handelt es sich um getrennte Vorgänge, die nicht synonym verwendet werden sollten.

Verwenden Sie stets den zurückgegebenen Code und die Nachricht, um den Status einer API-Anfrage zu ermitteln.

API-Antwortcodes anzeigen →

Eine 201-Antwort bedeutet, dass der Vorgang zur Verarbeitung angenommen wurde, aber noch nicht zwingend seinen Endzustand erreicht hat.

Bei der Domainregistrierung zeigt die Antwort 201 an, dass der Auftrag übermittelt wurde und auf die abschließende Bearbeitung durch die Registry wartet.

Teilen Sie einem Endkunden erst dann mit, dass die Domain aktiv ist, wenn Ihr System das endgültige Ergebnis bestätigt hat. Beachten Sie die Dokumentation des Registrierungsendpunkts bezüglich der aktuellen Regeln zur Bearbeitung ausstehender Aufträge und Rückerstattungen.

Ein ausstehender Transfer bedeutet, dass der Transferantrag zur Bearbeitung angenommen wurde, nicht jedoch, dass der Transfer der Domain zu NiceNIC bereits abgeschlossen ist.

Der Abschluss des Transfers kann von der Bearbeitung durch Registry und Registrar sowie vom aktuellen Transferstatus der Domain abhängen. Belassen Sie den Transfer im Status „Ausstehend“ (pending), bis der Abschluss bestätigt ist.

Ja. Die API List Domains unterstützt den Portfolio-Abruf mit Paginierungs-, Sortier- und Filteroptionen.

Verwenden Sie Domain-Details abrufen, wenn Sie detaillierte Informationen zu einer einzelnen Domain benötigen, wie z. B. Registrierungsdaten, Ablaufdaten, Nameserver und Domain-Kontaktdaten.

Die NiceNIC-Domain-API v2 umfasst Abuse- & Compliance-Operationen, die für Plattformen und Reseller konzipiert sind, die Kunden-Domainportfolios verwalten.

Sie können Domains identifizieren, die mit Missbrauchsmeldungen verknüpft sind, und maschinenlesbare Compliance-Informationen für einzelne Domains abrufen. Je nach Fall kann die Antwort den Domain-Status, aktuelle Auswirkungen, empfohlene Maßnahmen, Hold-Informationen, Beschwerdedaten und gemeldete URLs enthalten.

Dadurch wird es möglich, den Compliance-Status direkt im eigenen Kundenportal oder Betriebssystem anzuzeigen.

Ja. NiceNIC bietet eine WHMCS-Registrar-Integration für Unternehmen, die WHMCS bereits für Abrechnung und Provisionierung nutzen.

Verwenden Sie die direkte Domain-API v2, wenn Sie eine eigene Anwendung oder eigene Arbeitsabläufe erstellen. Verwenden Sie die WHMCS-Integration, wenn Sie Domainvorgänge in eine bestehende WHMCS-Umgebung einbinden möchten.

WHMCS-Integration ansehen →

Jede serverseitige Programmiersprache oder Laufzeitumgebung, die HTTPS-Anfragen senden und JSON verarbeiten kann, lässt sich mit der Domain-API v2 integrieren.

Gängige Optionen sind PHP, Python, Node.js und Java. Bewahren Sie API-Zugangsdaten serverseitig auf und legen Sie Ihr API-Secret niemals in browserseitigem JavaScript oder herunterladbarem Client-Code offen.

Ratenbegrenzungen (Rate Limiting) können angewendet werden, um die API-Stabilität und Plattform-Sicherheit zu gewährleisten.

Wenn Ihre Produktivintegration voraussichtlich ein dauerhaft hohes Anfragevolumen erzeugt, kontaktieren Sie NiceNIC vor dem Start, damit Ihr erwartetes Nutzungsmuster überprüft werden kann.

Geben Sie den Zeitstempel der Anfrage, API-Kategorie und -Aktion, ggf. den Domainnamen, nicht-sensible Anfrageparameter, den zurückgegebenen Antwortcode und die Meldung an sowie die Angabe, ob die Anfrage aus der Testumgebung oder der Produktionsumgebung stammte.

Ticket einreichen →

Nutzen Sie die API-Navigation in der Dokumentation. Jede Operation verfügt über eine eigene Seite mit unterstützten Parametern, Anfragebeispielen, Antwortbeispielen und operationsspezifischem Verhalten.

Die FAQ erläutern das allgemeine API-Verhalten; die Dokumentation der einzelnen Endpunkte gilt als maßgebliche Referenz für das genaue Anfrageformat.

API-Dokumentation öffnen →