API — Domains

Domain registrieren

Muss vor POST /api/routes aufgerufen werden.

POST /api/domains
Content-Type: application/json

{ "domain": "play.meinserver.de" }

Antwort:

{
  "domain": "play.meinserver.de",
  "verificationToken": "abc123...",
  "cnameTarget": "abc123....front-fra.blackprotect.net"
}

cnameTarget ist der empfohlene CNAME-Wert (routet Traffic und verifiziert). verificationToken bleibt der Wert für den TXT-Fallback.

DNS verifizieren

Startet die Verifizierung asynchron. Akzeptiert wird entweder ein CNAME auf <token>.front-fra.blackprotect.net oder der TXT-Fallback _blackprotect.<domain> mit dem Token.

POST /api/domains/:domain/verify

Antwort (202, Prüfung gestartet):

{
  "status": "verification_started",
  "verified": false,
  "recordTypePrimary": "CNAME",
  "cnameTarget": "abc123....front-fra.blackprotect.net",
  "recordName": "_blackprotect.play.meinserver.de",
  "recordType": "TXT"
}

Der DNS-Lookup läuft im Hintergrund. Poll anschließend GET /api/domains und warte, bis der Eintrag verified: true meldet.

Domain löschen

DELETE /api/domains/:domain