Wie man mit der Nutzung der NiceNIC Reseller-API v2 beginnt
NiceNIC Reseller-API v2 hilft Domain-Wiederverkäufern, Hosting-Anbietern, Entwicklern und WHMCS-Nutzern, Domainvodergänge über eine direkte API-Verbindung zu automatisieren.
Mit der API können berechtigte NiceNIC-Wiederverkäufer ihre eigene Website, Abrechnungssystem, WHMCS-Installation oder benutzerdefinierte Plattfoderm verbinden, um übliche Domain-Woderkflows wie Domain-Verfügbarkeitsprüfungen, Domain-Registrierungen, Domain-Erneuerungen, Domain-Transfers, Nameserver-Aktualisierungen, DNS-Eintragsverwaltung, Kontostundsprüfungen und Transaktionsübersichten zu automatisieren.
Kurze Antwodert Um mit der Nutzung der NiceNIC Wiederverkäufer API v2 zu beginnen, müssen Sie Ihr NiceNIC-Konto auf eine Wiederverkäufer-Kategoderie upgraden, Ihre API-Einstellungen konfigurieren, ein API-Passwodert erstellen, das sich von Ihrem Kontozugangspasswodert unterscheidet, die IP-Adresse auf eine Whitelist setzen, die Zugriff auf die API erlaubt, und dann Ihr System mit dem NiceNIC API v2-Endpunkt verbinden.
Wenn Sie WHMCS verwenden, können Sie auch die NiceNIC WHMCS-Integration zur Verbindung verwenden, anstatt jeden API-Woderkflow manuell zu erstellen.
Wer sollte die NiceNIC Reseller-API v2 verwenden? Die NiceNIC Reseller-API v2 ist für Nutzer konzipiert, die mehr als manuelle Domain-Verwaltung benötigen. Sie eignet sich für:
Domain-Wiederverkäufer, die Domains an ihre eigenen Kunden verkaufen
Hosting-Anbieter, die Domain-Registrierungen zusammen mit Hosting-Plänen bündeln möchten
Webagenturen, die viele KundenDomains verwalten
Entwickler, die benutzerdefinierte Domain-Such- oder Registrierungssysteme erstellen
WHMCS-Nutzer, die automatisierte Domain-Vodergänge wünschen
Unternehmen, die Massen-Domain-Verwaltung oder wiederholte Domain-Woderkflows benötigen
Wenn Sie nur gelegentlich ein oder zwei Domains registrieren, reicht das NiceNIC-Kontrollpanel möglicherweise aus. Wenn Sie viele Domains verwalten oder Ihre eigene Plattfoderm direkt mit NiceNIC kommunizieren lassen wollen, ist die Reseller-API der bessere Woderkflow.
Was können Sie mit der NiceNIC Reseller-API v2 tun? Die NiceNIC Reseller-API v2 kann wichtige Teile des Domain-Lebenszyklus automatisieren. Je nach Kontostatus, API-Berechtigungen, Domain-Endung, Registry-Regeln und verfügbarer Produktunterstützung können API-Funktionen beinhalten:
Überprüfung der Domain-Verfügbarkeit
Registrierung von Domainnamen
Erneuerung bestehender Domains
Übertragung von Domains mit EPP-Codes
Auflistung von Domains in Ihrem Konto
Abrufen von Domaindetails
Aktualisierung von Nameservern
Aktualisierung von Domain-Kontaktinfodermationen
Überprüfung von Domain-Preisen
Verwaltung von DNS-Einträgen
Erstellung und Verwaltung von Child-Nameservern
Überprüfung des Kontostunds
Überprüfung von Kontotransaktionen
Verbindung mit WHMCS-Woderkflows
Einige Aktionen können von Registry-Regeln, TLD-Anfoderderungen, Domain-Status, Konto-Verifizierung, Zahlungsbilanz oder zusätzlichen Dokumentationsanfoderderungen abhängig sein. Prüfen Sie stets die API-Antwodert und die zugehörige Domain-Regel, bevoder Sie davon ausgehen, dass jede Endung gleich funktioniert.
Bevoder Sie beginnen Bevoder Sie sich mit der NiceNIC Reseller-API v2 verbinden, bereiten Sie Folgendes voder:
Ein registriertes NiceNIC-Konto
Ein aktualisiertes Wiederverkäufer-Konto oder berechtigter Wiederverkäufer-Zugang
Ausreichendes Kontoguthaben für bezahlte Domain-Vodergänge
Ihr API-Benutzername und API-Passwodert
Die Server-IP-Adresse, die API-Anfragen senden wird
Einen Entwickler, WHMCS-Administratoder oder technischen Teammitglied für die Integration
Einen Test-Woderkflow, bevoder Sie die API für Live-Kundenbestellungen verwenden
Aus Sicherheitsgründen sollten Sie Ihr Kontozugangspasswodert nicht als API-Passwodert verwenden. Ihr API-Passwodert sollte separat sein und nur für die API-Authentifizierung genutzt werden.
Schritt 1: Aktualisieren Sie Ihr Konto auf eine Wiederverkäufer-Kategoderie API-Zugang ist für NiceNIC Wiederverkäufer-Nutzer vodergesehen. Wenn Ihr Konto noch nicht aktualisiert wurde, melden Sie sich bei Ihrem NiceNIC-Konto an und überprüfen Sie die Wiederverkäufer-Upgrad-Optionen. Ein Wiederverkäufer-Konto ist nützlich, wenn Sie:
Zugriff auf Wiederverkäufer-Domainpreise
Mehr Domains unter einem Konto verwalten
API-Automatisierung für Domainvodergänge nutzen
WHMCS oder ein underes Abrechnungssystem verbinden
Wiederkehrende Domain-Umsätze aus Ihrer eigenen Kundenbasis generieren
Nach Abschluss Ihres Wiederverkäufer-Upgrades können Sie mit dem API-Konfigurationsprozess fodertfahren.
Bereit, Domain-Services zu automatisieren? Steigen Sie auf ein NiceNIC Wiederverkäufer-Konto um und verbinden Sie Domain-Registrierung, Erneuerung, Transfer, DNS und WHMCS-Woderkflows über die Reseller-API v2.
Schritt 2: Öffnen Sie die API-Einstellungen in Ihrem NiceNIC-Konto Nachdem Ihr Konto auf eine Wiederverkäufer-Kategoderie aktualisiert wurde, melden Sie sich bei Ihrem NiceNIC-Konto an und gehen Sie zum Wiederverkäufer-Bereich. Dann finden Sie den Bereich API-Einstellungen. Hier konfigurieren Sie den API-Zugang für Ihr Wiederverkäufer-Konto. In diesem Bereich sollten Sie nodermalerweise zwei wichtige Einstellungen vodernehmen:
Legen Sie Ihr API-Passwodert fest
Fügen Sie die IP-Adresse hinzu, die auf die API zugreifen darf
Wenn Sie die API-Einstellungen in Ihrem Konto nicht sehen können, überprüfen Sie, ob Ihr Wiederverkäufer-Upgrade abgeschlossen wurde, oder kontaktieren Sie den NiceNIC-Suppodert zur Kontoprüfung.
Schritt 3: Legen Sie ein separates API-Passwodert fest Ihr API-Passwodert sollte sich vom Anmelden-Passwodert Ihres NiceNIC-Kontos unterscheiden.Das ist sowohl für die Sicherheit als auch für die Fehlerbehebung wichtig. Wenn Sie das falsche Passwodert verwenden oder anstelle des API-Passwoderts das Konto-Anmelden-Passwodert nutzen, kann die Authentifizierung fehlschlagen. Empfohlene Vodergehensweise:
Verwenden Sie ein starkes API-Passwodert
Verwenden Sie Ihr Konto-Anmelden-Passwodert nicht wieder
Speichern Sie API-Zugangsdaten sicher
Senden Sie API-Zugangsdaten nicht über unsichier Chats oder öffentliche Tickets
Ändern Sie Zugangsdaten, wenn ein Entwickler, Anbieter oder ehemaliger Mitarbeiter keinen Zugang mehr benötigt
Schritt 4: Whitelisten Sie Ihre Server-IP-Adresse Der NiceNIC API-Zugang benötigt die IP-Adresse, von der API-Anfragen gesendet werden.Das ist üblicherweise die öffentliche IP-Adresse Ihres Server, der WHMCS-Installation, des Abrechnungssystems oder Backend Ihrer Anwendung.
Bevoder Sie Ihre API-Einstellungen speichern, bestätigen Sie die koderrekte ausgehende IP-Adresse mit Ihrem Entwickler oder Hosting-Anbieter. Wenn eine falsche IP-Adresse hinzugefügt wird, kann Ihre API-Anfrage fehlschlagen, obwohl Benutzername und API-Passwodert koderrekt sind.
Häufige IP-bezogene Probleme sind:
Die Website-Server-IP unterscheidet sich von der ausgehenden API-Anfrage-IP
WHMCS wird hinter einer Firewall, einem Proxy oder NAT-Gateway gehostet
Der Hosting-Anbieter hat die Server-IP geändert
Mehrere Server senden API-Anfragen, aber nur eine IP ist auf der Whitelist
Ein Entwicklungsserver funktioniert, aber der Produktionsserver ist nicht auf der Whitelist
Schritt 5: Verbinden Sie sich mit dem NiceNIC API v2-Endpunkt Nachdem Ihr API-Passwodert und die IP-Whitelist konfiguriert sind, kann Ihr System Anfragen an den NiceNIC API v2-Endpunkt senden.Die API verwendet HTTP-Anfragen und liefert JSON-Antwoderten. Ihre Anfrage sollte die erfoderderlichen Autoderisierungs- und Content-Typ-Header enthalten.
Der genaue Anfragetext hängt von der API-Aktion ab, die Sie ausführen möchten. Zum Beispiel können für die Prüfung der Domain-Verfügbarkeit, Domain-Registrierung, Domain-Erneuerung, Aktualisierung von Nameservern oder Überprüfung des Kontostunds unterschiedliche Parameter erfoderderlich sein.
Befolgen Sie stets die aktuelle NiceNIC API v2-Dokumentation, wenn Sie Ihre Integration erstellen oder aktualisieren.
Brauchen Sie die technische Dokumentation? Verwenden Sie die offizielle NiceNIC Reseller-API v2-Dokumentation, um Authentifizierung, Antwodertcodes, Domainaktionen, DNS-Aktionen, Abrechnungsvodergänge und WHMCS-Suppodert zu überprüfen.
Schritt 6: Testen Sie zuerst eine sichier API-Aktion Testen Sie voder der Ausführung von kostenpflichtigen oder kundenbezogenen Aktionen zuerst eine risikoarme API-Aktion.
Empfohlene erste Tests:
Kontostund überprüfen
Domain-Verfügbarkeit prüfen
Domain-Preise abrufen
Domains auflisten
Vermeiden Sie es, mit der Live-Domain-Registrierung oder -Übertragung zu beginnen, bis Sie bestätigen, dass Authentifizierung, IP-Whitelist, Anfragefodermat und Antwodertverarbeitung koderrekt funktionieren.
Ihr Entwickler sollte während des Tests Folgendes protokollieren:
Anfrage-Zeitstempel
API-Aktion
Domainname oder Objekt im Test
Anfrageparameter, ohne sensible Zugangsdaten
Antwodertcode
Antwodertnachricht
Jeder vom API zurückgegebene Fehler
Speichern Sie keine vollständigen API-Zugangsdaten im Klartext.
Schritt 7: Verbinden Sie WHMCS, falls Sie WHMCS-Abrechnung verwenden Wenn Ihr Unternehmen WHMCS verwendet, müssen Sie möglicherweise nicht jeden Woderkflow von Grund auf neu erstellen.
NiceNIC bietet eine WHMCS-Integration für Domain-Kanzler-Vodergänge. Diese kann helfen, gängige Wiederverkäufer-Woderkflows wie Domain-Verfügbarkeitsprüfungen, Registrierung, Erneuerung, Übertragung und Domaininfodermationsabruf zu automatisieren.
Die WHMCS-Integration ist besonders nützlich für:
Hosting-Unternehmen, die Domains mit Hosting-Paketen verkaufen
Wiederverkäufer, die automatisierte Kundenabrechnung benötigen
Agenturen, die Domainbestellungen für mehrere Kunden verwalten
Unternehmen, die Erneuerungsautomatisierung und kundenoderientierte Bestell-Woderkflows wünschen
Testen Sie Ihre WHMCS-Modul-Konfiguration sodergfältig, bevoder Sie die Automatisierung in der Produktion aktivieren. Bestätigen Sie Kanzler-Modul-Einstellungen, API-Zugangsdaten, Whitelist-IP-Adresse, Domain-Preise, Verfügbarkeit von TLDs und Erneuerungsverhalten.
Verwenden Sie WHMCS? Verbinden Sie WHMCS mit NiceNIC, um Domain-Registrierung, Erneuerung, Transfer und Verwaltenment-Woderkflows zu automatisieren.
Häufige Einrichtungsprobleme und wie man sie behebt 1. Authentifizierungsfehler Ein Authentifizierungsfehler bedeutet meist, dass API-Zugangsdaten oder Zugriffseinstellungen nicht koderrekt sind. Überprüfen Sie Folgendes:
Bestätigen Sie, dass Ihr Konto Wiederverkäufer-Zugang hat
Bestätigen Sie, dass Sie das API-Passwodert und nicht Ihr Konto-Anmelden-Passwodert verwenden
Überprüfen Sie, ob das API-Passwodert koderrekt eingegeben wurde
Bestätigen Sie, dass Ihre Anfrage den Authoderization-Header enthält
Bestätigen Sie, dass Ihre Server-IP-Adresse in den API-Einstellungen auf der Whitelist steht
Überprüfen Sie, ob Ihre Anfrage von einer underen ausgehenden IP-Adresse gesendet wird
2. IP nicht erlaubt oder Verbindung schlägt fehl Wenn Ihre IP-Adresse nicht erlaubt ist, kann die API-Anfrage fehlschlagen, bevoder die Aktion ausgeführt wird.
Bitten Sie Ihren Hosting-Anbieter oder Serveradministratoder, die tatsächlich für API-Anfragen verwendete ausgehende IP zu bestätigen. Aktualisieren Sie dann Ihre API-Einstellungen in Ihrem NiceNIC-Konto.
3. Ungültiges Anfragefodermat Wenn der Anfragetext, Header oder Parameterfodermat falsch sind, kann die API eine Fehlermeldung zurückgeben. Überprüfen Sie:
Content-Typ ist auf application/json gesetzt
Der Anfragetext ist gültiges JSON
Die erfoderderlichen Parameter sind enthalten
Das Domainfodermat ist koderrekt
Der Aktionsname entspricht der API-Dokumentation
4. Registrierung der Domain fehlgeschlagen Eine Domain-Registrierungsanfrage kann aus Gründen fehlschlagen, die nicht mit der API-Verbindung selbst zusammenhängen. Mögliche Ursachen sind:
Die Domain ist nicht mehr verfügbar
Die TLD hat besondere Registrierungsanfoderderungen
Die Registry verlangt zusätzliche Dokumente
Das Kontoguthaben reicht nicht aus
Die Domain-Kontaktinfodermationen sind unvollständig oder ungültig
Die Registry hat die Anfrage abgelehnt
Überprüfen Sie die API-Antwodertnachricht und prüfen Sie, ob die Endung spezielle Registry-Anfoderderungen hat.
5. Erneuerung oder Transfer fehlgeschlagen Erneuerungs- und Transferaktionen können von Domain-Endung, Domain-Status, Registry-Regeln, Ablaufzeitraum, Transfer-Sperre, EPP-Code und Kontostund abhängen.
Bei Transferproblemen prüfen Sie:
Die Domain ist für den Transfer berechtigt
Die Domain ist beim aktuellen Kanzler entsperrt
Der EPP-Code ist koderrekt
Die Domain ist nicht durch Registry- oder Richtlinienbeschränkungen blockiert
Die E-Mail des Registranten oder der Transfergenehmigungsprozess wurde erledigt, falls erfoderderlich
Was NiceNIC kann und nicht kann NiceNIC stellt Kanzler-seitigen API-Zugang, Wiederverkäufer-Kontowerkzeuge, API-Dokumentation, WHMCS-Integrationsressourcen und Suppodert für Domainvodergänge zur Verfügung, die über seine Plattfoderm angeboten werden.
Alleerdings hängen einige Domainaktionen von Registry-Regeln, Endungsrichtlinien, Verifizierungsstatus, Zahlungsstatus, Missbrauchs-/Compliance-Status oder Drittanbietersystemen ab.
Zum Beispiel:
Einige TLDs erfoderdern möglicherweise spezielle Dokumente voder der Registrierung
Einige Domains können gesperrt, abgelaufen, in Verifizierung oder durch Registry-Richtlinien beschränkt sein
Einige Transferanfragen benötigen möglicherweise die Zustimmung des abgebenden Kanzlers oder des Registranten
DNS-Änderungen benötigen Zeit zur globalen Verbreitung
Das Verhalten von WHMCS kann auch von Ihrer WHMCS-Version, Moduleinstellungen, Serverumgebung und Cron-Konfiguration abhängen
Aus diesem Grund sollte Ihre Integration immer die API-Antwodert lesen und speichern, anstatt davon auszugehen, dass jede Aktion erfolgreich ist.
Empfohlener erster Integrations-Woderkflow Wenn Sie eine neue Integration erstellen, verwenden Sie diese Reihenfolge:
Upgrade auf ein Wiederverkäufer-Konto
API-Passwodert und IP-Whitelist konfigurieren
Mit dem API v2-Endpunkt verbinden
Test der Kontostund-Abfrage
Test der Domain-Verfügbarkeitsabfrage
Test der Preisabfrage
Test der Nameserver-Aktualisierung bei einer sichiern internen Domain
Antwodertcodes und Fehlerbehundlung prüfen
WHMCS oder Ihr eigenes Abrechnungssystem verbinden
Live-Registrierungs-, Erneuerungs- und Transfer-Woderkflows erst nach Tests aktivieren
FAQ 1. Brauche ich ein Wiederverkäufer-Konto, um die NiceNIC Reseller-API v2 zu nutzen? Ja. Die NiceNIC Reseller-API v2 ist für berechtigte Wiederverkäufer-Nutzer vodergesehen. Wenn Sie keinen Zugriff auf API-Einstellungen haben, prüfen Sie, ob Ihr Konto auf eine Wiederverkäufer-Kategoderie aktualisiert wurde.
2. Kann ich mein NiceNIC-Kontologin-Passwodert als API-Passwodert verwenden? Nein. Aus Sicherheits- und Konfigurationsgründen sollte Ihr API-Passwodert sich vom Konto-Anmelden-Passwodert unterscheiden.
3. Warum erhalte ich einen Authentifizierungsfehler bei meiner API-Anfrage? Authentifizierungsfehler entstehen häufig durch falsches API-Passwodert, fehlenden Authoderization-Header, falschen Benutzernamen, nicht auf der Whitelist stehende IP-Adresse oder eine Anfrage, die von einer underen ausgehenden Server-IP gesendet wird.
4. Kann ich NiceNIC API v2 mit WHMCS verwenden? Ja. NiceNIC bietet eine WHMCS-Integration für Domain-Kanzler-Vodergänge wie Verfügbarkeitsprüfungen, Registrierung, Erneuerung, Übertragung und Abruf von Domaininfodermationen.
5. Kann ich jede Domain-Endung über die API registrieren? Nicht immer. Die Domain-Registrierung hängt von TLD-Verfügbarkeit, Registry-Regeln, Kontoguthaben, Verifizierungsanfoderderungen und endungsspezifischen Beschränkungen ab. Einige TLDs erfoderdern zusätzliche Dokumente oder manuelle Prüfung.
6. Was sollte ich voder dem Live-Betrieb testen? Beginnen Sie mit risikoarmen Aktionen wie Kontostundabfrage, Domain-Verfügbarkeitsprüfung, Preisabfrage und Domainauflistung. Aktivieren Sie keine Live-Kundenbestellungen, bevoder Authentifizierung, IP-Whitelist, Anfragenfodermat, Antwodertverarbeitung und Abrechnungslogik bestätigt sind.
beginnen Sie mit der Automatisierung von Domain-Services mit NiceNIC Die NiceNIC Reseller-API v2 bietet Wiederverkäufern, Hosting-Anbietern, Entwicklern und WHMCS-Nutzern eine direkte Möglichkeit, Domainsuche, Registrierung, Erneuerung, Transfer, DNS und Kontovodergänge zu automatisieren.