API-Dokumentation

Domain transferieren

Transferiere eine bestehende Domain von einem anderen Registrar zu Sitequest. Dieser Endpunkt erstellt eine Bestellung, belastet deine gespeicherte Zahlungsmethode und leitet den Domain-Transfer ein. Verwende den Bestellstatus-Endpunkt, um den Fortschritt zu verfolgen.

Domain-Transfers dauern in der Regel 5-7 Tage, abhängig von der TLD und dem Transfer-Freigabeprozess des aktuellen Registrars.

Anfrage

POST /api/v1/domains/transfer

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 zum Transferieren (z.B. example.com)
authCode Ja Der Auth-Code (Transferschlüssel) der Domain vom aktuellen Registrar
period Nein Registrierungszeitraum in Jahren (Standard: 1, max: 10)

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 zu transferierende Domain
status string completed, payment_pending oder payment_failed
paymentId string Mollie-Zahlungs-ID

Statuswerte

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

Voraussetzungen

Vor dem Transfer einer Domain:

  1. Auth-Code vom aktuellen Registrar anfordern
  2. Domain beim aktuellen Registrar entsperren (Transfer-Lock deaktivieren)
  3. Sicherstellen, dass die Domain nicht innerhalb von 60 Tagen nach Registrierung oder einem vorherigen Transfer steht (ICANN-Sperrfrist)
  4. Dein Sitequest-Konto muss eine gültige Zahlungsmethode hinterlegt haben

Fehlerantworten

Status Code Beschreibung
400 MISSING_DOMAIN Das Feld domain ist erforderlich
400 INVALID_DOMAIN Ungültiges Domain-Format
400 MISSING_AUTHCODE Das Feld authCode ist für Transfers erforderlich
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 INSUFFICIENT_SCOPE API-Schlüssel hat nicht den erforderlichen domains:provision-Scope
409 DUPLICATE_ORDER Eine identische Bestellung ist bereits ausstehend

Beispiel

# Domain transferieren
curl -X POST https://hosting.site.quest/api/v1/domains/transfer \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com", "authCode": "Xy9!kL3mN"}'

# Transfer mit 2-Jahres-Verlängerung
curl -X POST https://hosting.site.quest/api/v1/domains/transfer \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com", "authCode": "Xy9!kL3mN", "period": 2}'

MCP

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