API-Dokumentation

Domain registrieren

Registriere einen neuen Domainnamen. Dieser Endpunkt erstellt eine Bestellung, belastet deine gespeicherte Zahlungsmethode und startet die Domain-Bereitstellung. Verwende den Bestellstatus-Endpunkt, um den Fortschritt zu verfolgen.

Anfrage

POST /api/v1/domains/register

Erforderlicher Scope: domains:provision

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Parameter Erforderlich Beschreibung
domain Ja Vollständiger Domainname (z.B. example.com)
period Nein Registrierungszeitraum in Jahren (Standard: 1, max: 10)
nameservers Nein Array benutzerdefinierter Nameserver (max 5). Wenn nicht angegeben, werden Sitequest-Standards verwendet.
whoisPrivacy Nein WHOIS-Datenschutz aktivieren (true oder false)

Antwort

{
  "data": {
    "orderId": "507f1f77bcf86cd799439011",
    "orderToken": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "domain": "example.com",
    "status": "completed",
    "paymentId": "tr_abc123"
  }
}

Antwortfelder

Feld Typ Beschreibung
orderId string Bestell-ID zur Nachverfolgung
orderToken string Bestell-Token (UUID) zur Nachverfolgung
domain string Die registrierte Domain
status string completed, payment_pending oder payment_failed
paymentId string Mollie-Zahlungs-ID

Statuswerte

Status Beschreibung
completed Zahlung erfolgreich, Domain wird bereitgestellt
payment_pending Zahlung eingeleitet (z.B. SEPA-Lastschrift), warte auf Bestätigung
payment_failed Zahlung wurde abgelehnt oder ist fehlgeschlagen

Voraussetzungen

Stelle vor der Nutzung dieses Endpunkts sicher, dass:

  1. Dein Konto mindestens einen Checkout über das Web-Dashboard abgeschlossen hat (um ein Zahlungsmandat einzurichten)
  2. Du eine gültige Zahlungsmethode hinterlegt hast
  3. Dein Konto nicht gesperrt ist

Fehlerantworten

Status Code Beschreibung
400 MISSING_DOMAIN Das Feld domain ist erforderlich
400 INVALID_DOMAIN Ungültiges Domain-Format
400 PRICING_UNAVAILABLE TLD wird nicht angeboten oder Preise nicht verfügbar
403 account_suspended Konto ist gesperrt
403 no_valid_mandate Keine gültige Zahlungsmethode hinterlegt
403 no_billing_address Rechnungsadresse fehlt
403 INSUFFICIENT_SCOPE API-Schlüssel hat nicht den erforderlichen domains:provision-Scope
409 DOMAIN_UNAVAILABLE Domain ist nicht zur Registrierung verfügbar
409 DUPLICATE_ORDER Eine identische Bestellung ist bereits ausstehend
502 DOMAIN_CHECK_FAILED Domain-Verfügbarkeit konnte nicht überprüft werden

Beispiel

# Domain registrieren
curl -X POST https://hosting.site.quest/api/v1/domains/register \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

# Registrierung mit benutzerdefinierten Nameservern und 2-Jahres-Zeitraum
curl -X POST https://hosting.site.quest/api/v1/domains/register \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example.com",
    "period": 2,
    "nameservers": ["ns1.custom.com", "ns2.custom.com"],
    "whoisPrivacy": true
  }'

MCP

Diese Aktion ist auch über das register_domain MCP-Tool verfügbar.