API-Übersicht
NiceNIC Domain-API v2: Dokumentation und Schnellstart
NiceNIC Domain-API v2 ist sowohl für Markt- als auch für Reseller-Konten verfügbar. Nutzen Sie diese Übersicht, um den Zugriff zu konfigurieren, Ihre erste Anfrage zu bestätigen, das API-Antwortmodell zu verstehen und direkt zum richtigen Abschnitt in der linken Navigation zu gelangen.
API-Zugriff und Reseller-Preise sind getrennt.
Market-Konto: API-Zugriff mit Market-Konto-Preisen.
Reseller-Konto: API-Zugriff mit den Preisen der aktuellen Reseller-Stufe.
Reseller-Stufen und Preise vergleichen →
Market-Konto: API-Zugriff mit Market-Konto-Preisen.
Reseller-Konto: API-Zugriff mit den Preisen der 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
Standardantwort bei Erfolg
{ "code": 0, "msg": "Erfolg", "data": {} }
API-Testumgebung
Testen Sie Ihre Integration vor dem Livegang
Nutzen Sie die NiceNIC-API-Sandbox, um Ihre Domain-API-Integration vor dem Produktivbetrieb zu testen. Validieren Sie Authentifizierung, API-Anfragen, Antwortverarbeitung und Ihren Anwendungsworkflow in einer dedizierten Testumgebung.
Ideal für Wiederverkäufer, Hosting-Anbieter, Entwickler und Plattformen, die eine API-Integration vorbereiten.
Schnellstart
Ihr erster API-Aufruf in 4 Schritten
Beginnen Sie mit einer schreibgeschützten Anfrage, bevor Sie Live-Registrierungen, Verlängerungen oder Transfers aktivieren. So können Sie Authentifizierung, Anfrageformat und Antwortverarbeitung validieren, ohne eine kostenpflichtige Bestellung aufzugeben.
1
API-Zugriff aktivieren
Öffnen Sie die API-Einstellungen, erstellen Sie Ihr API-Secret oder rufen Sie es ab und konfigurieren Sie bei Bedarf 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, Kontostand oder Domain-Auflistung.
4
Antwort verarbeiten
Lesen und speichern Sie den zurückgegebenen code und msg, bevor Sie kostenpflichtige Produktionsaktionen aktivieren.
Empfohlene erste Anfrage: Domain-Verfügbarkeit
Der Verfügbarkeits-Endpunkt unterstützt mehrere Domains in einer einzelnen Anfrage, indem die 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 gewünschten Workflow
Die folgende Übersicht spiegelt die linke Navigation wider. Nutzen Sie sie, um den passenden Workflow zu identifizieren, und öffnen Sie dann die dedizierte Endpunkt-Seite für Parameter, Anforderungsbeispiele und Antwortbeispiele.
| Abschnitt | Einsatzmöglichkeiten | Dokumentierte Funktionen |
|---|---|---|
| Erste Schritte | Sicher verbinden und verstehen, wie Antworten verarbeitet werden. | API-Übersicht, API-Testumgebung, Authentifizierung, Antwortcodes. |
| Domain-Verwaltung | Automatisieren Sie den gesamten Domain-Lebenszyklus. | Verfügbarkeit, Domains auflisten, Domain-Details, Registrierung, Verlängerung, Eingehender Transfer, Nameserver, Kontakte, Preise. |
| Missbrauch & Compliance | Überwachen Sie Domains, die Compliance-Aufmerksamkeit erfordern. | Domains mit Missbrauchsmeldungen auflisten und maschinenlesbaren Missbrauchsstatus, Lebenszyklus von Sperrungen, Beschwerdeinformationen und empfohlene Maßnahme abrufen. |
| DNS-Einträge | Verwalten Sie gehostete DNS-Einträge programmgesteuert. | DNS-Einträge auflisten, erstellen, aktualisieren und löschen. |
| Child-Nameserver | Verwalten Sie Host- / Glue-Einträge für Nameserver unter Ihrer eigenen Domain. | Child-Nameserver erstellen, auflisten, aktualisieren und löschen. |
| Konto & Abrechnung | Verbinden Sie Automatisierung mit Prüfungen auf Kontoebene. | Kontostand und transaktionsbezogene Kontoinformationen. |
| WHMCS-API | Integrieren Sie NiceNIC in einen bestehenden WHMCS-Abrechnungsworkflow. | Verfügbarkeitsprüfung, Registrierung, Verlängerung, Transfer, Domaindetails, Nameserver, Kontakte und weitere Funktionen des Registrar-Moduls. |
| API – Häufig gestellte Fragen | Beantworten Sie häufige Fragen zu Zugriff, Sicherheit, Tests und Arbeitsabläufen. | Berechtigung, Anmeldedaten, Anfrageabwicklung, unterstützte Operationen und Integrationsanleitung. |
Empfohlener Arbeitsablauf
Empfohlene Reihenfolge für die erste Integration
Eine zuverlässige Produktionsintegration sollte Zugriffs- und Kaufbedingungen validieren, bevor sie echte Kundenbestellungen übermittelt.
1. Authentifizierung
API-Geheimnis + autorisierte IP
API-Geheimnis + autorisierte IP
→
2. Verfügbarkeit
Schreibgeschützter Konnektivitätstest
Schreibgeschützter Konnektivitätstest
→
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
Verarbeiten Sie code + msg
Verarbeiten Sie code + msg
→
6. Live-Operationen
Registrieren / Verlängern / Übertragen
Registrieren / Verlängern / Übertragen
Gehen Sie nicht davon aus, dass eine API-Anfrage abgeschlossen ist, nur weil sie akzeptiert wurde. Einige Operationen können einen ausstehenden Status zurückgeben und erfordern dennoch eine Verarbeitung durch die Registry, bevor der endgültige Status der Domain bestätigt wird.
Verhalten in der Produktion
Erfolgs-, ausstehende und Fehlerantworten verstehen
code: 0 — Erfolgreiche Antwort Aktuelle Endpunkt-Beispiele verwenden code 0 für erfolgreich abgeschlossene Antworten.
code: 201 — Ausstehende Bestellung Registrierungs- und Transferdokumentation kann code 201 zurückgeben, wenn eine Bestellung übermittelt wurde, die endgültige Verarbeitung jedoch noch aussteht.
code: 400 — Anfragefehler Endpunkt-Beispiele verwenden code 400 für Parameterfehler in Anfragen.
Verhalten bei ausstehender Registrierung
Für die Domain-Registrierung besagt die aktuelle Dokumentation, dass eine 201-Antwort bedeutet, dass die Bestellung erfolgreich übermittelt und die Gebühr abgebucht wurde, die endgültige Aktivierung jedoch noch der Bestätigung durch die Registrierungsstelle unterliegt. Falls die Domain nicht aktiviert werden kann, wird die Registrierungsgebühr innerhalb von 24 Stunden auf das NiceNIC-Kontoguthaben zurückerstattet.
Verhalten bei ausstehenden Transfers
Der Transfer-Endpunkt dokumentiert auch 201 als ausstehende Bestellung. Ihre Anwendung sollte daher einen ausstehenden Transfer als zur Verarbeitung angenommen behandeln, nicht als Nachweis, dass der Transfer bereits abgeschlossen ist.
Preise
Preise vor kostenpflichtigen Vorgängen abfragen
Der Preis-Endpunkt von NiceNIC kann Registrierungs-, Verlängerungs- und Transferpreise für eine Domain abrufen. Die dokumentierten type-Werte sind register, renew, transfer und all. Der dokumentierte Zeitraum beträgt 1 bis 10 Jahre, wobei tld-spezifische Ausnahmen möglich sind.
Antworten zur Registrierungspreisen können auch ein is_premium-Flag zurückgeben. Verwenden Sie den Preis-Endpunkt, bevor Sie eine kostenpflichtige Anfrage senden, wenn Ihre Anwendung die aktuellen kontobezogenen Kosten kennen muss.
Der kostenlose API-Zugang ändert Ihre Preisstufe nicht. Marktkonten verwenden die Marktpreisgestaltung; Reseller-Konten verwenden die Preise, die ihrer aktuellen Reseller-Stufe zugewiesen sind.
Domain- & DNS-Verwaltung
Den Unterschied zwischen Nameservern, DNS-Einträgen und Child-Nameservern verstehen
| Vorgang | Einsatzzweck | Dokumentierte Funktion |
|---|---|---|
| Nameserver aktualisieren | Sie möchten eine Domain an andere autoritative Nameserver delegieren. | Der Endpunkt für Domain-Nameserver unterstützt primäre, sekundäre und zusätzliche Nameserver, wobei die vorliegende Seite eine Obergrenze von bis zu sechs dokumentiert. |
| DNS-Einträge | Sie nutzen das DNS-Hosting von NiceNIC 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 ns1.example.com. |
Erstellen, auflisten, aktualisieren und löschen Sie Child-Nameserver. Der Create-Endpunkt erfordert, dass der Nameserver-Hostname mit der Domain übereinstimmt, und akzeptiert eine IP-Adresse. |
Portfolio und Compliance
Portfolio-Überwachung automatisieren – nicht nur Domain-Bestellungen
Die Domain API v2 umfasst auch Leseoperationen, die nach der Registrierung nützlich sind. Der Endpunkt „List Domains“ unterstützt Paginierung, Sortierung, Statusfilter und Hold-Filter, während „Get Domain Details“ Registrierungsdaten, Ablaufdaten, Nameserver und die Kontaktinformationen des Registranten zurückgibt.
Missbrauchs- & Compliance-Überwachung
Die Abuse & Compliance-API von NiceNIC kann Domains mit Missbrauchsmeldungen auflisten und eine detaillierte maschinenlesbare Zusammenfassung für eine bestimmte Domain zurückgeben. Der detaillierte Missbrauchs-Endpunkt dokumentiert sechs domainbezogene Statusbegriffe: Normal, Under Review, Pending ClientHold, ClientHold, Closed und ServerHold.
Die Antwort kann aktuelle Auswirkungen, empfohlene nächste Schritte, Hold-Status und Zeitplan, Anzahl der Beschwerden, Beschwerdedaten, Kategorien, DNS-Missbrauchsklassifizierung, Evidenzstatus und gegebenenfalls gemeldete URLs umfassen. Dadurch können Plattformen und Reseller den Compliance-Status direkt in ihren eigenen Betriebssystemen anzeigen, anstatt sich nur auf manuelle Prüfungen zu verlassen.
Direkte API oder WHMCS
Wählen Sie das Integrationsmodell, das zu Ihrem System passt
| Option | Am besten geeignet für | Was die aktuelle Dokumentation bietet |
|---|---|---|
| Domain-API v2 | Eigene Websites, SaaS-Plattformen, interne Systeme, individuelle Abrechnungs- oder Bereitstellungsworkflows. | Direkte HTTPS- und JSON-Integration für Domain-, DNS-, Child-Nameserver-, Konto- und Compliance-Operationen. |
| WHMCS-Modul | Hosting-Unternehmen und Reseller, die bereits WHMCS verwenden. | Verfügbarkeit, Registrierung, Verlängerung, Transfer, Domain-Details, Nameserver, Kontakte, Sperren/Entsperren, EPP-Abruf, Fehlerprotokollierung und optionaler Testmodus. |
Die aktuelle WHMCS-Dokumentation listet als Anforderungen WHMCS 7.0 oder höher, PHP 7.0 oder höher mit cURL, gültige NiceNIC-API-Anmeldedaten und SSL/TLS-Unterstützung auf.
Fehlerbehebung
Wenn eine API-Anfrage fehlschlägt
Beginnen Sie mit der zurückgegebenen Antwort und dem Konfigurationsstatus, anstatt dieselbe kostenpflichtige Aktion wiederholt zu erneut zu versuchen.
Authentifizierungs- oder Zugriffsfehler
- Bestätigen Sie den NiceNIC-Benutzernamen und das API-Geheimnis.
- Stellen Sie sicher, dass der Authorization-Header vorhanden und korrekt formatiert ist.
- Bestätigen Sie, dass das API-Geheimnis nicht zurückgesetzt oder rotiert wurde.
- Wenn IP-Einschränkungen aktiviert sind, stellen Sie sicher, dass die Anfrage von der autorisierten ausgehenden Server-IP stammt.
Fehler bei Anforderungsparametern
- Vergleichen Sie die Anforderung mit den dokumentierten Parametern des jeweiligen Endpunkts.
- Bestätigen Sie die erforderlichen Werte, Formate und Aktionsnamen.
- Prüfen Sie gegebenenfalls die tld-spezifischen Registrierungszeiträume oder Kontaktanforderungen.
Bezahlte Vorgänge werden nicht sofort abgeschlossen
- Lesen Sie den zurückgegebenen
codeund diemsg. - Behandeln Sie eine ausstehende
201-Antwort nicht als endgültigen Abschluss. - Vergewissern Sie sich vor dem erneuten Versuch einer bezahlten Aktion über den Kontostand und die aktuellen Preise.
Benötigen Sie NiceNIC-Support?
- Notieren Sie den Zeitstempel der Anfrage und die API-Aktion.
- Geben Sie, falls zutreffend, den betroffenen Domainnamen oder das betroffene Objekt an.
- Geben Sie den zurückgegebenen Code und die Meldung an.
- Teilen Sie nur unkritische Parameter mit; geben Sie niemals das vollständige API-Geheimnis in einem Ticket an.
Nächster Schritt
Beginnen Sie mit einer sicheren Testanfrage
Aktivieren Sie den API-Zugriff, bestätigen Sie die Authentifizierung, führen Sie eine Verfügbarkeits- oder Preisanfrage aus und überprüfen Sie Ihre Antwortverarbeitung, bevor Sie kostenpflichtige kundenorientierte Vorgänge aktivieren.
Zuletzt verifiziert: 26. August 2026
