Domainreselling API

Beachten Sie bitte auch unsere ausführliche technische Dokumentation der API und ihrer Methoden und die ergänzenden Informationen zur Authentifizierung und zur Nutzung.

Mit der Domainreselling-Funktionalität (Domainreselling API) der CCP API können Sie als Domainreseller vielfältige Aktionen mit Domains durchführen. So erlaubt die API Ihnen, Domains zu registrieren und zu transferieren, Kontakthandles anzulegen, Domains Handles zuzuweisen und vieles mehr.

Die zur Verfügung stehende Funktionalität orientiert sich dabei unter anderem an den Möglichkeiten, die Ihnen das Domainreselling bereits im CCP bietet. Dazu sei hier auf unsere entsprechende Dokumentation verwiesen.

Im Folgenden beschreiben wir die Grundlagen zur Nutzung der Domainreselling-API.

---

Voraussetzungen

Um die Domainreselling-API nutzen zu können, müssen Sie bestimmte Voraussetzungen erfüllen:

• Sie müssen Domain-Reseller von netcup sein, um die Domainreselling-API nutzen zu können: Bestellung Reseller-Level

• Die Domainreselling-API richtet sich an Kunden, die bereits Erfahrung mit Aktionen, die Domains betreffen, gesammelt haben.

• Bei Verwendung von Funktionen der API, welche die Angabe von Nameservern erfordern, ist es nötig, mindestens zwei eigene Nameserver zu betreiben. In diesem Fall können Sie nicht die von uns bereitgestellten Nameserver nutzen. Möchten Sie diese verwenden, so führen Sie nach der Registrierung oder dem Transfer die nötigen Aktionen bitte über ihr CCP durch.
  • Verwenden Sie auf Ihrem vServer zum Beispiel das vorkonfigurierte PowerDNS Image von netcup, um selbst Nameserver zu installieren.

---

Funktionen

Mit der Domainreselling-API können Sie aktuell:

• Sich an der API anmelden bzw. abmelden
  • Methoden: login bzw. logout
• Kontakthandles anlegen, bearbeiten und löschen
  • Methoden: createHandle, updateHandle und deleteHandle

• Alle angelegten Kontakthandles auflisten lassen
  • Methode: listallHandle

• Domains registrieren und transferieren
  • Methoden: createDomain und transferDomain

• Alle angelegten Domains auflisten lassen
  • Methode: listallDomains

• Authcodes für Domains beantragen
  • Methode: getAuthcodeDomain

• Domains kündigen
  • Methode: cancelDomain

• Inhaberwechsel von Domains durchführen
  • Methode: changeOwnerDomain

• Domain-UPDATEs durchführen (Handles und Nameserver ändern)
  • Methode: updateDomain

• Informationen über eine Domain bzw. ein Kontakthandle erhalten
  • Methoden: infoDomain bzw. infoHandle

• Den Preis einer bestimmten TLD erhalten
  • Methode: priceTopleveldomain

• Rückmeldungen zu durchgeführten Domainaufträgen erhalten und diese als gelesen markieren
  • Methoden: poll und ackpoll

Alle Änderungen, die Sie über die API durchführen, sind auch im CCP ersichtlich, umgekehrt gilt das Gleiche.

---

Einschränkungen

• Bei dem Ausführen von Domainbestellungen über die API (mittels der Methoden createDomain / transferDomain):
  • Es ist nötig, eigene Handles anzugeben. Es ist dabei nicht möglich, unsere Standardhandles zu verwenden.
    • Sollten für eine Domain unsere Standardhandles gesetzt sein, ist eine Kündigung und ein Inhaberwechsel der Domain nur über das CCP möglich.
  • Domains werden immer als zusätzliche Domains angelegt. Es ist nicht möglich, Inklusivdomains über die API zu registrieren.

• Wie bereits in den Voraussetzungen genannt, müssen Sie bei der Nutzung von Funktionen der API, bei der die Angabe von Nameservern erforderlich ist, eigene Nameserver angeben und somit betreiben. Dabei können Sie auf unseren vServern auch unser PowerDNS-Image nutzen.

Sollten Sie die obige Funktionalität dennoch nutzen wollen, so können Sie die gewünschten Aktionen über Ihr CCP tätigen.

• Gespeichert werden im Logging ausschließlich die folgenden Aktionen: cancelDomain, createDomain, changeOwnerDomain, createHandle, deleteHandle, getAuthcodeDomain, transferDomain, updateDnsRecords, updateDnsZone, updateDomain, updateHandle

---

Nutzung der API

Möchten Sie die Funktionen der API verwenden, so finden Sie die nötigen Informationen zur Authentifizierung, sowie technische Informationen zur Verwendung der API unter CCP API.