API-Übersicht
NiceNIC Domain-API v2 Dokumentation & Schnellstart
Die NiceNIC Domain-API v2 steht sowohl für Standardkundenkonten als auch für Reseller-Konten zur Verfügung. Nutzen Sie diese Übersicht, um den Zugriff zu konfigurieren, Ihre erste Anfrage zu verifizieren, das API-Antwortmodell zu verstehen und direkt zum gewünschten Abschnitt in der linken Navigation zu wechseln.
API-Zugriff und Reseller-Preise sind unabhängig voneinander.
Standardkundenkonto: API-Zugriff mit den Konditionen für Endkunden.
Reseller-Konto: API-Zugriff mit den Preisen der jeweils aktuellen Reseller-Stufe.
Reseller-Stufen und Preise vergleichen →
Standardkundenkonto: API-Zugriff mit den Konditionen für Endkunden.
Reseller-Konto: API-Zugriff mit den Preisen der jeweils aktuellen Reseller-Stufe.
Reseller-Stufen und Preise vergleichen →
Basis-Endpunkt
https://api.nicenic.net/v2/
Erforderliche Header
Host: api.nicenic.net Authorization: username:api_secret Content-Type: application/json
Standard-Erfolgsantwort
{ "code": 0, "msg": "success", "data": {} }
API-Testumgebung
Testen Sie Ihre Integration vor dem Livegang
Nutzen Sie die NiceNIC-API-Testumgebung, um Ihre Domain-API-Integration vor dem Wechsel in die Produktionsumgebung zu testen. Validieren Sie Authentifizierung, API-Anfragen, Antwortverarbeitung und Ihren Anwendungs-Workflow in einer dedizierten Testumgebung.
Ideal für Reseller, Hosting-Anbieter, Entwickler und Plattformen, die eine API-Integration vorbereiten.
Schnellstart
Ihr erster API-Aufruf in 4 Schritten
Beginnen Sie mit einer Nur-Lese-Anfrage, bevor Sie Live-Registrierungen, Verlängerungen oder Transfers aktivieren. So können Sie Authentifizierung, Anfrageformatierung und Antwortverarbeitung validieren, ohne eine kostenpflichtige Bestellung aufzugeben.
1
API-Zugriff aktivieren
Öffnen Sie die API-Einstellungen, erstellen oder rufen Sie Ihr API-Secret ab und konfigurieren Sie gegebenenfalls autorisierte Server-IPs.
2
Authentifizierung bestätigen
Verwenden Sie HTTPS mit dem Authorization-Header im Format username:api_secret.
3
Einen sicheren Test durchführen
Beginnen Sie mit Domain-Verfügbarkeit, Preisen, Kontoguthaben oder der Domain-Liste.
4
Antwort verarbeiten
Lesen und speichern Sie die zurückgegebenen Werte code und msg, bevor Sie kostenpflichtige Aktionen in der Produktivumgebung ausführen.
Empfohlene erste Anfrage: Domain-Verfügbarkeit
Der Verfügbarkeits-Endpunkt unterstützt mehrere Domains in einer Anfrage, indem Domainnamen durch Kommas getrennt werden.
curl "https://api.nicenic.net/v2/?category=domain&action=check&domains=example.com,example.net" \ -H "Authorization: username:api_secret" \ -H "Content-Type: application/json"
API-Übersicht
Wählen Sie den benötigten Workflow
Die folgende Übersicht spiegelt die linke Navigation wider. Verwenden Sie sie, um den passenden Workflow auszuwählen, und öffnen Sie anschließend die entsprechende Endpunkt-Seite für Parameter, Anfragebeispiele und Antwortbeispiele.
| Abschnitt | Verwendungszweck | Dokumentierte Funktionen |
|---|---|---|
| Erste Schritte | Sicher verbinden und die Antwortverarbeitung verstehen. | API-Übersicht, API-Testumgebung, Authentifizierung, Antwortcodes. |
| Domainverwaltung | Automatisieren Sie den Kernlebenszyklus von Domains. | Verfügbarkeit, Domains auflisten, Domain-Details, Registrierung, Verlängerung, Eingehender Transfer, Nameserver, Kontakte, Preise. |
| Missbrauch & Compliance | Domains überwachen, die Compliance-Maßnahmen erfordern. | Listen Sie Domains mit Missbrauchsmeldungen auf und rufen Sie maschinenlesbare Missbrauchsstatus, Hold-Lebenszyklen, Beschwerdeinformationen und Handlungsempfehlungen ab. |
| DNS-Einträge | Gehostete DNS-Einträge programmatisch verwalten. | DNS-Einträge auflisten, erstellen, aktualisieren und löschen. |
| Child-Nameserver | Host- / Glue-Records für Nameserver unter Ihrer eigenen Domain verwalten. | Erstellen, Auflisten, Aktualisieren und Löschen von Child-Nameservern. |
| Konto & Abrechnung | Automatisierung mit Prüfungen auf Kontoebene verbinden. | Kontoguthaben und transaktionsbezogene Kontoinformationen. |
| WHMCS API | NiceNIC in einen bestehenden WHMCS-Abrechnungs-Workflow integrieren. | Verfügbarkeit, Registrierung, Verlängerung, Transfer, Domaindetails, Nameserver, Kontakte und zusätzliche Registrar-Modulfunktionen. |
| API-FAQ | Beheben Sie häufige Fragen zu Zugriff, Sicherheit, Tests und Workflows. | Berechtigung, Zugangsdaten, Anfrageverarbeitung, unterstützte Operationen und Integrationshinweise. |
Empfohlener Workflow
Empfohlene erste Integrationsreihenfolge
Eine zuverlässige Produktionsintegration sollte Zugriffs- und Einkaufsbedingungen validieren, bevor sie Live-Kundenaufträge übermittelt.
1. Authentifizierung
API-Secret + autorisierte IP
API-Secret + autorisierte IP
→
2. Verfügbarkeit
Schreibgeschützter Verbindungstest
Schreibgeschützter Verbindungstest
→
3. Preise
Aktuelle Kosten auf Kontoebene abfragen
Aktuelle Kosten auf Kontoebene abfragen
→
4. Guthaben
Guthaben für kostenpflichtige Aktionen bestätigen
Guthaben für kostenpflichtige Aktionen bestätigen
→
5. Antwortverarbeitung
Code + Nachricht verarbeiten
Code + Nachricht verarbeiten
→
6. Live-Operationen
Registrieren / Verlängern / Transferieren
Registrieren / Verlängern / Transferieren
Gehen Sie nicht davon aus, dass eine API-Anfrage abgeschlossen ist, nur weil sie akzeptiert wurde. Einige Vorgänge können den Status „Ausstehend“ zurückgeben und erfordern noch die Verarbeitung durch die Registry, bevor der endgültige Domain-Status bestätigt ist.
Produktionsverhalten
Erfolgs-, Ausstehend- und Fehlerantworten verstehen
code: 0 — Erfolgreiche Antwort Aktuelle Endpunkt-Beispiele verwenden Code 0 für erfolgreich ausgeführte Antworten.
code: 201 — Ausstehender Auftrag Die Registrierungs- und Transfer-Dokumentation kann den Code 201 zurückgeben, wenn ein Auftrag übermittelt wurde, die endgültige Bearbeitung jedoch noch aussteht.
code: 400 — Anfragefehler Endpunkt-Beispiele verwenden Code 400 für Anfragen mit fehlerhaften Parametern.
Verhalten bei ausstehender Registrierung
Für die Domain-Registrierung besagt die aktuelle Dokumentation, dass eine Antwort mit dem Code 201 bedeutet, dass der Auftrag erfolgreich übermittelt und der Betrag abgebucht wurde, die endgültige Aktivierung jedoch noch der Bestätigung durch die Registry unterliegt. Kann die Domain nicht aktiviert werden, wird die Registrierungsgebühr innerhalb von 24 Stunden auf das NiceNIC-Kontoguthaben zurückerstattet.
Verhalten bei ausstehendem Transfer
Der Transfer-Endpunkt dokumentiert 201 ebenfalls als ausstehenden Auftrag. Ihre Anwendung sollte einen ausstehenden Transfer daher als zur Bearbeitung angenommen behandeln und nicht als Nachweis dafür, dass der Transfer bereits abgeschlossen ist.
Preise
Preise vor kostenpflichtigen Vorgängen abfragen
Über den Preis-Endpunkt von NiceNIC können Registrierungs-, Verlängerungs- und Transferpreise für eine Domain abgerufen werden. Die dokumentierten type-Werte lauten register, renew, transfer und all. Der dokumentierte Zeitraum beträgt 1 bis 10 Jahre; TLD-spezifische Ausnahmen sind möglich.
Antworten zu Registrierungspreisen können auch ein is_premium-Flag zurückgeben. Nutzen Sie den Preis-Endpunkt vor dem Absenden einer kostenpflichtigen Anfrage, wenn Ihre Anwendung die aktuellen Kosten auf Kontoebene benötigt.
Der kostenlose API-Zugriff ändert Ihre Preisstufe nicht. Standardkundenkonten nutzen die Preise für Standardkunden; Reseller-Konten nutzen die ihrer aktuellen Reseller-Stufe zugewiesenen Preise.
Domain- & DNS-Operationen
Unterschiede zwischen Nameservern, DNS-Einträgen und Child-Nameservern verstehen
| Operation | Einsatzzweck | Dokumentierte Funktion |
|---|---|---|
| Nameserver aktualisieren | Sie möchten eine Domain an andere autoritative Nameserver delegieren. | Der Domain-Nameserver-Endpunkt unterstützt primäre, sekundäre und zusätzliche Nameserver; auf der aktuellen Seite ist ein Limit von bis zu sechs dokumentiert. |
| DNS-Einträge | Sie nutzen das NiceNIC-DNS-Hosting und müssen Zoneneinträge verwalten. | Für das Auflisten, Erstellen, Aktualisieren und Löschen von DNS-Einträgen sind separate APIs dokumentiert. |
| Child-Nameserver | Sie benötigen Host- / Glue-Records wie beispielsweise ns1.example.com. |
Child-Nameserver erstellen, auflisten, aktualisieren und löschen. Der Erstellungs-Endpunkt erfordert, dass der Hostname des Nameservers zur Domain passt, und akzeptiert eine IP-Adresse. |
Portfolio & Compliance
Automatisieren Sie die Portfolio-Überwachung, nicht nur Domain-Bestellungen
Die Domain-API v2 umfasst auch Leseoperationen, die nach der Registrierung nützlich sind. Der Endpunkt „Domains auflisten“ unterstützt Paginierung, Sortierung sowie Status- und Hold-Filterung, während „Domaindetails abrufen“ Registrierungsdaten, Ablaufdaten, Nameserver und Kontaktdaten des Domaininhabers zurückgibt.
Missbrauchs- & Compliance-Überwachung
Die Abuse- & Compliance-API von NiceNIC kann Domains mit Missbrauchsmeldungen auflisten und eine detaillierte, maschinenlesbare Übersicht für eine bestimmte Domain zurückgeben. Der Endpunkt für detaillierte Missbrauchsinformationen dokumentiert sechs Statusbezeichnungen auf Domainebene: Normal, Under Review, Pending ClientHold, ClientHold, Closed und ServerHold.
Die Antwort kann aktuelle Auswirkungen, empfohlene nächste Schritte, Hold-Status und -Zeitplan, Beschwerdeanzahl, Beschwerdedaten, Kategorien, DNS-Abuse-Klassifizierung, Beweisstatus und gegebenenfalls gemeldete URLs enthalten. Dadurch können Plattformen und Reseller den Compliance-Status in ihren eigenen Betriebssystemen anzeigen, anstatt sich ausschließlich auf manuelle Überprüfungen zu verlassen.
Direkte API oder WHMCS
Wählen Sie das Integrationsmodell, das zu Ihrem System passt
| Option | Optimal für | Was die aktuelle Dokumentation bietet |
|---|---|---|
| Domain-API v2 | Individuelle Websites, SaaS-Plattformen, interne Systeme, benutzerdefinierte Abrechnungs- oder Bereitstellungs-Workflows. | Direkte HTTPS- + JSON-Integration für Domain-, DNS-, Child-Nameserver-, Konto- und Compliance-Operationen. |
| WHMCS-Modul | Hosting-Unternehmen und Reseller, die bereits WHMCS nutzen. | Verfügbarkeit, Registrierung, Verlängerung, Transfer, Domain-Details, Nameserver, Kontakte, Sperren/Entsperren, EPP-Code-Abruf, Fehlerprotokollierung und optionaler Testmodus. |
Die aktuelle WHMCS-Dokumentation listet WHMCS 7.0 oder höher, PHP 7.0 oder höher mit cURL, gültige NiceNIC-API-Zugangsdaten sowie SSL/TLS-Unterstützung als Voraussetzungen auf.
Fehlerbehebung
Wenn eine API-Anfrage fehlschlägt
Prüfen Sie zunächst die zurückgegebene Antwort und den Konfigurationsstatus, anstatt dieselbe kostenpflichtige Aktion wiederholt auszuführen.
Authentifizierungs- oder Zugriffsfehler
- Bestätigen Sie den NiceNIC-Benutzernamen und das API-Secret.
- Stellen Sie sicher, dass der Authorization-Header vorhanden und korrekt formatiert ist.
- Stellen Sie sicher, dass das API-Secret nicht zurückgesetzt oder rotiert wurde.
- Wenn IP-Beschränkungen aktiviert sind, stellen Sie sicher, dass die Anfrage von der autorisierten ausgehenden Server-IP stammt.
Fehlerhafter Anfrageparameter
- Gleichen Sie die Anfrage mit den dokumentierten Parametern des jeweiligen Endpunkts ab.
- Erforderliche Werte, Formate und Aktionsnamen prüfen.
- Prüfen Sie gegebenenfalls TLD-spezifische Registrierungszeiträume oder Kontaktanforderungen.
Kostenpflichtiger Vorgang wird nicht sofort abgeschlossen
- Lesen Sie die zurückgegebenen Werte
codeundmsgaus. - Betrachten Sie eine ausstehende Antwort
201nicht als endgültigen Abschluss. - Prüfen Sie Kontostand und aktuelle Preise, bevor Sie eine kostenpflichtige Aktion erneut ausführen.
NiceNIC-Hilfe erforderlich
- Protokollieren Sie den Zeitstempel der Anfrage und die API-Aktion.
- Geben Sie gegebenenfalls den betroffenen Domainnamen oder das Objekt an.
- Geben Sie den zurückgegebenen Code und die Meldung an.
- Geben Sie nur unkritische Parameter weiter; posten Sie das API-Secret niemals vollständig in einem Ticket.
Nächster Schritt
Mit einer sicheren Testanfrage beginnen
Aktivieren Sie den API-Zugriff, bestätigen Sie die Authentifizierung, führen Sie eine Verfügbarkeits- oder Preisabfrage durch und überprüfen Sie Ihre Antwortverarbeitung, bevor Sie kostenpflichtige Vorgänge für Kunden freischalten.
Zuletzt überprüft: 26. August 2026
