Häufig gestellte Fragen zur NiceNIC Domain-API v2

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

Sie unterstützt zentrale Arbeitsabläufe wie Verfügbarkeitsprüfungen von Domains, Registrierung, Verlängerung, Übertragung, Portfolioabfragen, Nameserver- und Kontaktaktualisierungen, Preisabfragen, DNS-Einträge, eigene Nameserver, Kontoinformationen und compliance-bezogene Vorgänge.

Nutzen Sie die API, wenn Sie NiceNIC-Domaindienste direkt mit einer Website, Hosting-Plattform, Abrechnungssystem, internen Tool oder einer anderen Anwendung verbinden möchten.

Jedes aktive NiceNIC-Konto kann die Domain API v2 nutzen. Der API-Zugriff steht sowohl Marktkonten als auch Reseller-Konten zur Verfügung.

Sie müssen kein Reseller werden, um API-Zugriff zu erhalten. Der Kontotyp ist dennoch für die Preisgestaltung relevant: kostenpflichtige API-Vorgänge verwenden die Preise, die dem NiceNIC-Konto zugewiesen sind, das die Anfrage sendet.

API-Einstellungen öffnen →

Ja. Der API-Zugriff selbst ist kostenlos. Für die Aktivierung des API-Zugriffs oder das Senden unterstützter API-Anfragen wird keine separate Gebühr erhoben.

Kostenpflichtige Vorgänge wie Domain-Registrierung, Verlängerung und Transfer werden gemäß Ihren Kontopreisen und den geltenden Domain-Regeln berechnet.

Nein. API-Zugriff und Reseller-Preise sind getrennt.

Sie können die Domain API v2 mit einem regulären NiceNIC Market-Konto verwenden. Aktualisieren Sie erst dann auf ein Reseller-Konto, wenn Reseller-Preise oder andere Reseller-Vorteile für Ihr Geschäftsvolumen nützlich sind.

Reseller-Pläne vergleichen →

Die Domain API v2 verwendet die aktuelle NiceNIC-API-Struktur mit HTTPS-Anfragen, JSON-Antworten, header-basierter Authentifizierung und Dokumentation, die um einzelne Domain- und Konto-Workflows strukturiert ist.

Wenn Sie eine Integration auf Basis einer älteren NiceNIC-API betreiben, überprüfen Sie die Parameter und die Antwortverarbeitung der API v2, bevor Sie Produktionsdaten übertragen, anstatt anzunehmen, dass die beiden Versionen austauschbar sind.

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

API-Einstellungen öffnen →

Ja. NiceNIC bietet eine API-Testumgebung, in der Entwickler ihre Integrationen testen können, bevor sie diese an die Produktions-API anbinden.

Nutzen Sie die Testumgebung, um Authentifizierung, Anfrageformatierung, Antwort-Parsing, Fehlerbehandlung und Ihren Anwendungsworkflow zu validieren, bevor Sie Live-Domainvorgänge für Kunden aktivieren.

API-Testumgebung öffnen →

Die API-Testumgebung ist für Entwicklungs- und Integrationstests gedacht. Die Produktions-API wird für Live-Domainvorgänge und kostenpflichtige Anfragen über Ihr NiceNIC-Konto verwendet.

Wir empfehlen, Authentifizierung, Anfrageverarbeitung, Antwortverarbeitung und Fehlerlogik in der Testumgebung zu validieren, bevor Sie kundenorientierte Produktionsvorgänge aktivieren.

Senden Sie API-Anfragen über HTTPS und fügen Sie im Authorization-Header Ihren NiceNIC-Benutzernamen und den geheimen API-Schlüssel 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 außerdem von einer autorisierten Server-IP stammen.

API-Authentifizierung lesen →

Der Basis-Endpunkt der Produktions-API lautet:

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

API-Aktionen werden anhand der für jeden Endpunkt dokumentierten Parameter ausgewählt, z. B. category und action. Befolgen Sie stets die spezifische Endpunkt-Dokumentation für die erforderlichen und optionalen Parameter einer bestimmten Operation.

Die Antworten der API v2 verwenden JSON, und die Anfrageparameter verwenden UTF-8.

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

Ihre Anwendung sollte den zurückgegebenen code und msg auswerten, statt anzunehmen, dass jede HTTP-Antwort einen abgeschlossenen Domain-Vorgang darstellt.

Mithilfe der derzeit dokumentierten APIs können Sie Arbeitsabläufe automatisieren, darunter Verfügbarkeitsprüfungen für Domains, Registrierung, Verlängerung und Transfer, Portfolioauflistung und Domaindetails, Nameserver- und Domain-Kontaktaktualisierungen, Domain-Preise, DNS-Einträge, Child-Nameserver, Kontoinformationen sowie die Überwachung von Missbrauch und Compliance.

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

Beginnen Sie mit risikoarmen Leseoperationen wie der Prüfung der Domain-Verfügbarkeit, der Domain-Preisabfrage, dem Kontostand und der Domain-Auflistung.

Bestätigen Sie dann Authentifizierung, Antwort-Parsing, Fehlerbehandlung und die Bearbeitung ausstehender Bestellungen, bevor Sie Live-Registrierungen, Verlängerungen oder Transfers aktivieren.

Ja. Der Endpunkt Domain-Verfügbarkeit prüfen unterstützt mehrere durch Kommas getrennte Domainnamen.

example.com,example.net,example.org

Gehen Sie nicht davon aus, dass jede API-Operation dasselbe Multi-Domain-Eingabeformat unterstützt. Registrierung, Verlängerung und Transfer sollten der jeweiligen Endpunktdokumentation folgen.

Verwenden Sie den Endpoint Get Domain Pricing. Die dokumentierten Preistypen umfassen register, renew, transfer und all.

Antworten auf Registrierungsabfragen können auch einen is_premium-Wert enthalten, der angibt, ob die abgefragte Registrierung eine Premium-Registrierung ist.

Da API-Bestellungen die Preisgestaltung auf Kontobene verwenden, fragen Sie die aktuellen Preise ab, bevor Sie bezahlte Kundenbestellungen übermitteln, statt sich unbegrenzt auf zwischengespeicherte Preise zu verlassen.

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

Registrierungszeiträume, Verlängerungszeiträume, Übertragungsberechtigung, Kontaktanforderungen und Verifizierungsanforderungen können je nach Endung unterschiedlich sein. Ihre Anwendung sollte die aktuellen Regeln für die jeweilige TLD befolgen.

Dies sind separate Vorgänge und sollten nicht als austauschbar behandelt werden.

Verwenden Sie zur Bestimmung des Status einer API-Anfrage stets den zurückgegebenen Code und die zugehörige Meldung.

API-Antwortcodes anzeigen →

Eine 201-Antwort bedeutet, dass der Vorgang zur Verarbeitung angenommen wurde, aber noch nicht unbedingt seinen endgültigen Status erreicht hat.

Bei einer Domain-Registrierung bedeutet eine 201-Antwort, dass die Bestellung übermittelt wurde und auf die abschließende Verarbeitung durch die Registry wartet.

Sagen Sie einem Endkunden erst, dass die Domain aktiv ist, wenn Ihr System das endgültige Ergebnis bestätigt hat. Beachten Sie in der Dokumentation zum Registrierungs-Endpunkt die aktuellen Regeln für ausstehende Bestellungen und Rückerstattungen.

Ein ausstehender Transfer bedeutet, dass die Transferanfrage zur Verarbeitung angenommen wurde – nicht, dass die Domain ihren Transfer zu NiceNIC bereits abgeschlossen hat.

Der Abschluss des Transfers kann von der Verarbeitung durch die Registry und den Registrar sowie vom aktuellen Transferstatus der Domain abhängen. Belassen Sie den Transfer bis zur Bestätigung des Abschlusses im Status „Ausstehender Transfer“.

Ja. Die List Domains-API unterstützt den Abruf von Portfolios mit Paginierung, Sortierung und Filteroptionen.

Verwenden Sie Get Domain Details, wenn Sie detaillierte Informationen zu einer einzelnen Domain benötigen, wie Registrierungsinformationen, Ablaufinformationen, Nameserver und Domain-Kontaktdaten.

Die NiceNIC Domain API v2 umfasst Abuse & Compliance-Operationen, die für Plattformen und Reseller entwickelt wurden, die Kunden-Domain-Portfolios 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, Beschwerdeinformationen und gemeldete URLs enthalten.

Dadurch können Sie den Compliance-Status direkt in Ihrem eigenen Kundenportal oder Betriebssystem anzeigen.

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

Verwenden Sie die direkte Domain-API v2, wenn Sie eine eigene Anwendung oder einen eigenen Workflow entwickeln. Nutzen Sie die WHMCS-Integration, wenn Sie Domain-Vorgänge in eine bestehende WHMCS-Umgebung integrieren möchten.

WHMCS-Integration anzeigen →

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

Zu den gängigen Optionen gehören PHP, Python, Node.js und Java. Bewahren Sie API-Zugangsdaten serverseitig auf und geben Sie Ihren geheimen API-Schlüssel niemals in JavaScript im Browser oder in herunterladbarem Client-Code preis.

Ratenbegrenzungen können angewendet werden, um die API-Stabilität und die Plattformsicherheit zu schützen.

Wenn für Ihre Produktionsintegration dauerhaft hohes Anfragevolumen erwartet wird, setzen Sie sich vor dem Start mit NiceNIC in Verbindung, damit Ihr erwartetes Nutzungsmuster geprüft werden kann.

Geben Sie den Zeitstempel der Anfrage, die API-Kategorie und -Aktion, den Domainnamen (sofern zutreffend), nicht sensible Anfrageparameter, den zurückgegebenen Antwortcode und die Antwortmeldung sowie an, ob die Anfrage aus der Sandbox oder der Produktionsumgebung stammte.

Ticket einreichen →

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

Die häufig gestellten Fragen erläutern das allgemeine API-Verhalten; die Dokumentation der einzelnen Endpunkte ist die maßgebliche Referenz für das genaue Anfrageformat.

API-Dokumentation öffnen →