Black Friday: Guthaben aufladen und doppeltes Guthaben erhalten, bis zu $50 gratis ($25 → $50, $50 → $100). Für alles nutzbar: Domains, Hosting, E-Mail. Code: BLACKFRIDAY2026 Doppeltes Guthaben sichern →

Geben Sie Ihrer KI einen Schlüssel. Damit verwaltet sie Ihre Domains.

Die NameOcean API ermöglicht es jedem Programm oder KI-Assistenten, das zu tun, was Sie im Dashboard tun: Domains suchen und registrieren, Nameserver ändern, DNS-Einträge bearbeiten, SSL-Zertifikate ausstellen, Ports öffnen und Domains an Ihre Server binden.

  1. 1

    Schlüssel erstellen

    Öffnen Sie Dashboard → API-Schlüssel, legen Sie fest, was der Schlüssel darf, und kopieren Sie ihn.

  2. 2

    An Ihre KI

    Fügen Sie den folgenden Prompt zusammen mit Ihrem Schlüssel in Claude, ChatGPT oder Cursor ein.

  3. 3

    Fragen Sie in einfachen Worten

    "Richten Sie blog.example.com auf 203.0.113.10 aus und aktivieren Sie SSL."

Prompt für Ihren KI-Assistenten

Sie können meine Domains mit der NameOcean-API verwalten. Lesen Sie https://nameocean.net/llms.txt, um zu erfahren, wie es funktioniert. Mein API-Schlüssel lautet: [Schlüssel hier einfügen]. Fragen Sie mich immer, bevor Sie kostenpflichtige Aktionen ausführen.

Geben Sie jedem Tool einen eigenen Schlüssel mit genau den Berechtigungen, die es braucht. Gerät ein Schlüssel in falsche Hände, löschen Sie ihn im Dashboard; die anderen funktionieren weiter.

Verbinden Sie Claude Code, Cursor oder einen beliebigen MCP-Client

NameOcean betreibt einen Remote-MCP-Server. Fügen Sie ihn einmal hinzu, und Ihre KI kann DNS, SSL, Server, Ports und Domainzuordnungen verwalten. Sie melden sich im Browser an; Sie müssen keinen API-Schlüssel einfügen und nichts installieren.

Claude Code
$ claude mcp add --transport http nameocean https://nameocean.net/mcp

Claude Desktop und claude.ai: Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen, URL https://nameocean.net/mcp. Cursor, VS Code, OpenCode und andere: Fügen Sie einen HTTP-MCP-Server mit derselben URL hinzu. Clients ohne OAuth können senden Authorization: Bearer <API key>.

API-Schlüssel und App-Verbindungen erfordern eine zweistufige Anmeldung in Ihrem Konto. Aktivieren

Der MCP-Server kann keine Domains registrieren oder verlängern und kein Guthaben aufladen. Einen kostenpflichtigen Server erstellt er erst, nachdem Sie dem Preis zugestimmt haben. Apps können Sie jederzeit trennen unter Dashboard → Verbundene Apps.

Einrichtung für jeden Client und alle Tools →

Kommandozeile

Die nameocean CLI erledigt dasselbe über Ihr Terminal und Ihre Skripte, und nameocean mcp install verbindet Claude Code, Cursor, OpenCode und VS Code für Sie.

nameocean
$ curl -fsSL https://nameocean.net/install.sh | sh
$ nameocean login
$ nameocean dns add example.com A @ 203.0.113.10

Installationsoptionen und alle Befehle →

Webhooks

Erhalten Sie einen signierten POST, wenn eine Domain registriert wird oder bald abläuft, sich ein DNS-Eintrag ändert oder ein Zertifikat ausgestellt wird – statt die API regelmäßig abzufragen.

Events, Payloads und Signaturprüfung →

E-Mail

Senden Sie transaktionale E-Mails von Ihrer eigenen Domain mit Zustellungsereignissen, erstellen Sie Postfächer, Aliase und Mailinglisten, aktivieren Sie die kostenlose Weiterleitung für hier registrierte Domains und empfangen Sie eingehende E-Mails als JSON an Ihrem Endpunkt.

Leitfaden zur Email API →

Authentifizierung

Senden Sie Ihren Schlüssel bei jeder Anfrage im Authorization-Header. Antworten werden als JSON zurückgegeben. Das Limit beträgt 120 Anfragen pro Minute.

curl
$ curl https://nameocean.net/api/v1/account \
    -H "Authorization: Bearer $NAMEOCEAN_API_KEY"

{"email": "you@example.com", "credit": "42.00", "currency": "USD", "domains": 3, "dns_zones": 3}

Schlüsselberechtigungen (Scopes)

Erstellen Sie unter Dashboard → API-Schlüssel beliebig viele Schlüssel, jeweils nur mit den Berechtigungen, die das jeweilige Tool benötigt, einem optionalen Ablaufdatum und einer optionalen Liste erlaubter IPs. Ein Schlüssel wird nur einmal angezeigt; NameOcean speichert lediglich seinen Fingerprint.

Ein Schlüssel kann auch auf einige Ihrer Domains beschränkt werden. Er funktioniert dann nur auf den Endpunkten dieser Domains (DNS, SSL, die Einstellungen der Domain, ihre E-Mail und Weiterleitung), sieht nur diese in GET /dns und erhält überall sonst 403 domain_not_allowed, auch bei Servern, Abrechnung und Ihren anderen Domains. Verwenden Sie einen solchen Schlüssel für CI-Jobs und Tools wie certbot, octoDNS oder DNSControl.

account:readE-Mail und Kontoguthaben
domains:readDomains auflisten, Verfügbarkeit und Preis prüfen
domains:writeAutomatische Verlängerung, Sperre und Nameserver ändern; Transfercode abrufen
dns:readDNS-Zonen und -Einträge auflisten
dns:writeZonen erstellen; Einträge hinzufügen, ändern und löschen
ssl:readZertifikatsstatus
ssl:writeZertifikate ausstellen, automatische Verlängerung ändern
servers:readApp-Server, ihre Ports und Domains
servers:writePorts öffnen und schließen, Domains verknüpfen und trennen
email:readMail-Domains, Postfächer, Aliasse, Weiterleitung und deren Protokoll
email:writePostfächer, Aliasse und Listen hinzufügen und löschen; Passwörter festlegen; Weiterleitung ein- und ausschalten
email:sendE-Mails aus Ihren Postfächern senden (POST /email/send)
monitors:readUptime-Monitore, ihr Status und Vorfälle
monitors:writeUptime-Monitore hinzufügen, ändern, pausieren und löschen
webhooks:readWebhook-Endpunkte und ihre Zustellungen
webhooks:writeWebhook-Endpunkte hinzufügen, ändern und löschen, Tests senden, Zustellungen erneut senden
billing:writeDomains registrieren und verlängern (verbraucht Kontoguthaben)

GET erfordert <area>:read, andere Methoden <area>:write. Das Registrieren und Verlängern einer Domain erfordert zusätzlich billing:write; das Verknüpfen einer Domain mit einem Server erfordert zusätzlich dns:write. Ein Aufruf ohne den Scope wird mit 403 und required_scopes beantwortet. Dieselben Regeln gelten für den MCP-Server, wenn er mit einem Schlüssel verwendet wird.

Endpunkte

Basis-URL: https://nameocean.net/api/v1/

Die API-Referenz enthält jedes Feld, jeden Fehlercode und ein curl-Beispiel pro Endpunkt; openapi.json lässt sich in Postman oder Insomnia importieren.

Domains

GET/domains/check?name=example.comVerfügbarkeit und Preis
GET/whois/{name}WHOIS/RDAP-Daten jeder Domain: Registrar, Daten, Status, Nameserver
GET/domainsIhre Domains auflisten
POST/domainsEine Domain registrieren, die aus Ihrem Guthaben bezahlt wird {"name", "years"}
GET/domains/{name}Details, Nameserver, SSL-Status
PATCH/domains/{name}Automatische Verlängerung und Transfersperre {"auto_renew", "locked"}
PUT/domains/{name}/nameservers{"nameservers": [...]} oder "nameocean"
POST/domains/{name}/renewUm ein Jahr verlängern (bis 60 Tage vor Ablauf)
GET/domains/{name}/auth-codeTransfercode

DNS

GET/dnsDNS-Zonen auflisten
POST/dnsEine Zone für eine anderswo registrierte Domain erstellen {"name"}
GET/dns/{zone}/recordsEinträge auflisten
POST/dns/{zone}/recordsDatensatz hinzufügen: A, AAAA, CNAME, MX, TXT, SRV, PTR, CAA, REDIRECT
PATCH/dns/{zone}/records/{type}/{id}Datensatz ändern
DELETE/dns/{zone}/records/{type}/{id}Datensatz löschen
POST/dns/{zone}/plan · applyDie gesamte Zone aus einer YAML- oder JSON-Datei ändern · DNS as Code →

SSL

GET/ssl/{zone}Status, Ablaufdatum und Download-Link
POST/ssl/{zone}Ein kostenloses Wildcard-Zertifikat ausstellen
PATCH/ssl/{zone}Automatisch erneuern {"auto_renew"}

App-Server

{server} ist die Server-ID oder die Standarddomain des Servers,例如 3f9a1c2e.nameocean.org.

GET/serversIhre Server mit SSH, Git-Remote, Ports und Domains
GET/servers/{server}Ein Server
GET/servers/{server}/portsOffene Ports
POST/servers/{server}/portsEinen TCP- oder UDP-Port öffnen {"port", "protocol"}
DELETE/servers/{server}/ports/{id}Einen Port schließen
GET/servers/{server}/domainsGebundene Domains und ihr Status
POST/servers/{server}/domainsEine Domain oder Subdomain mit HTTPS binden {"domain"}
DELETE/servers/{server}/domains/{id}Domain-Bindung aufheben
POST/servers/{server}/deploysNach git push: Apps neu starten und Deployment protokollieren
GET/servers/{server}/logsApp-Logs · alle Server-Endpunkte →

Beispiel: Neue Domain mit HTTPS

bash
# 1. Preis prüfen
curl "https://nameocean.net/api/v1/domains/check?name=kahvebot.com" -H "Authorization: Bearer $KEY"

# 2. Registrieren (belastet Ihr Guthaben)
curl -X POST https://nameocean.net/api/v1/domains -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" -d '{"name": "kahvebot.com", "years": 1}'

# 3. Auf Ihren Server verweisen
curl -X POST https://nameocean.net/api/v1/dns/kahvebot.com/records -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" -d '{"type": "A", "hostname": "@", "ip": "203.0.113.10", "ttl": "5m"}'

# 4. Kostenloses Wildcard-SSL
curl -X POST https://nameocean.net/api/v1/ssl/kahvebot.com -H "Authorization: Bearer $KEY"

Der vollständige Referenztext für KI-Agenten, mit allen Feldern und Datensatztypen, ist unter nameocean.net/llms.txt verfügbar. GET /api/v1/ beschreibt sich außerdem selbst.