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.
Öffnen Sie Dashboard → API-Schlüssel, legen Sie fest, was der Schlüssel darf, und kopieren Sie ihn.
Fügen Sie den folgenden Prompt zusammen mit Ihrem Schlüssel in Claude, ChatGPT oder Cursor ein.
"Richten Sie blog.example.com auf 203.0.113.10 aus und aktivieren Sie SSL."
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.
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 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.
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.
$ curl -fsSL https://nameocean.net/install.sh | sh $ nameocean login $ nameocean dns add example.com A @ 203.0.113.10
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.
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.
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 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}
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:read | E-Mail und Kontoguthaben |
domains:read | Domains auflisten, Verfügbarkeit und Preis prüfen |
domains:write | Automatische Verlängerung, Sperre und Nameserver ändern; Transfercode abrufen |
dns:read | DNS-Zonen und -Einträge auflisten |
dns:write | Zonen erstellen; Einträge hinzufügen, ändern und löschen |
ssl:read | Zertifikatsstatus |
ssl:write | Zertifikate ausstellen, automatische Verlängerung ändern |
servers:read | App-Server, ihre Ports und Domains |
servers:write | Ports öffnen und schließen, Domains verknüpfen und trennen |
email:read | Mail-Domains, Postfächer, Aliasse, Weiterleitung und deren Protokoll |
email:write | Postfächer, Aliasse und Listen hinzufügen und löschen; Passwörter festlegen; Weiterleitung ein- und ausschalten |
email:send | E-Mails aus Ihren Postfächern senden (POST /email/send) |
monitors:read | Uptime-Monitore, ihr Status und Vorfälle |
monitors:write | Uptime-Monitore hinzufügen, ändern, pausieren und löschen |
webhooks:read | Webhook-Endpunkte und ihre Zustellungen |
webhooks:write | Webhook-Endpunkte hinzufügen, ändern und löschen, Tests senden, Zustellungen erneut senden |
billing:write | Domains 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.
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.
| GET | /domains/check?name=example.com | Verfügbarkeit und Preis |
| GET | /whois/{name} | WHOIS/RDAP-Daten jeder Domain: Registrar, Daten, Status, Nameserver |
| GET | /domains | Ihre Domains auflisten |
| POST | /domains | Eine 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}/renew | Um ein Jahr verlängern (bis 60 Tage vor Ablauf) |
| GET | /domains/{name}/auth-code | Transfercode |
| GET | /dns | DNS-Zonen auflisten |
| POST | /dns | Eine Zone für eine anderswo registrierte Domain erstellen {"name"} |
| GET | /dns/{zone}/records | Einträge auflisten |
| POST | /dns/{zone}/records | Datensatz 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 · apply | Die gesamte Zone aus einer YAML- oder JSON-Datei ändern · DNS as Code → |
| GET | /ssl/{zone} | Status, Ablaufdatum und Download-Link |
| POST | /ssl/{zone} | Ein kostenloses Wildcard-Zertifikat ausstellen |
| PATCH | /ssl/{zone} | Automatisch erneuern {"auto_renew"} |
{server} ist die Server-ID oder die Standarddomain des Servers,例如 3f9a1c2e.nameocean.org.
| GET | /servers | Ihre Server mit SSH, Git-Remote, Ports und Domains |
| GET | /servers/{server} | Ein Server |
| GET | /servers/{server}/ports | Offene Ports |
| POST | /servers/{server}/ports | Einen TCP- oder UDP-Port öffnen {"port", "protocol"} |
| DELETE | /servers/{server}/ports/{id} | Einen Port schließen |
| GET | /servers/{server}/domains | Gebundene Domains und ihr Status |
| POST | /servers/{server}/domains | Eine Domain oder Subdomain mit HTTPS binden {"domain"} |
| DELETE | /servers/{server}/domains/{id} | Domain-Bindung aufheben |
| POST | /servers/{server}/deploys | Nach git push: Apps neu starten und Deployment protokollieren |
| GET | /servers/{server}/logs | App-Logs · alle Server-Endpunkte → |
# 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.