Domainbestellung für den Checkout vorbereiten

POST /orders/prepare

Bezeichner: PrepareOrder

Bereitet eine Domainbestellung vor und gibt einen Link in den regfish-Checkout zurück. Dieser Aufruf bestellt, bezahlt und reserviert NICHTS: Der Kunde öffnet den Link, prüft die Positionen und schließt den Kauf im Checkout ab (AGB, Zahlung, Kontakte). Verwenden Sie ihn, wenn die Person, für die Sie arbeiten, ausdrücklich Domains registrieren oder transferieren möchte, und zeigen Sie ihr den zurückgegebenen Link.

Für jede Domain entscheidet der Registry-Status über den Vorgang: Ein freier Name wird als Registrierung vorbereitet, ein vergebener als Transfer (der Auth-Code wird im Checkout eingegeben, nie hier). Domains, die sich nicht bestellen lassen, kommen mit Begründung zurück und fehlen im Link. Preise sind Bruttobeträge in EUR wie im Checkout; der Checkout bepreist bei der Bestellung neu.

Der Link gilt 24 Stunden, ist an das Konto des Zugangs gebunden und lässt sich einmal übernehmen. Grenzen: 20 Domains je Aufruf, 30 vorbereitete Bestellungen je Konto und Stunde, 100 je Tag.

Request Body

prepareOrderRequest

Feld	Typ	Pflicht	Beschreibung
items	object[]	ja

Antworten

Status	Typ	Beschreibung
200	prepareOrderResponse	Vorbereitete Bestellung mit Checkout-Link
400	Error	Ungültige Anfrage
401	Error	Nicht autorisiert
403	Error	Recht order:prepare fehlt, oder das Konto ist gesperrt
422	Error	Keine der Domains kann bestellt werden
429	Error	Zu viele vorbereitete Bestellungen
502	Error	Verfügbarkeit konnte nicht ermittelt werden

Antwortkörper

Feld	Typ	Pflicht	Beschreibung
success	boolean	ja	Erfolgskennzeichen
code	integer	nein	Antwort-/Fehlercode
response	prepareOrderResponse	nein

Beispiel

curl -X POST "https://api.regfish.com/orders/prepare" \
  -H "x-api-key: $REGFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "domain": "string",
        "action": "register"
      }
    ]
  }'

Anfrage zusammenstellen

Werte eintragen: Der Aufruf unten passt sich an. Es wird nichts abgeschickt: die API gibt Browser-Anfragen von dieser Domain aus derzeit nicht frei (CORS). Der API-Key wird nicht gespeichert.