Entwickler → Schnellstart
In fünf Minuten: ein API-Schlüssel, eine Verfügbarkeitsprüfung für eine Domain, ein DNS-Eintrag und ein Webhook, der Ihren Code benachrichtigt, wenn sich der Eintrag ändert. Jeder Schritt funktioniert mit curl oder der nameocean CLI.
Öffnen Sie Dashboard → API-Schlüssel und erstellen Sie einen Schlüssel mit account:read, domains:read, dns:write und webhooks:write. Er wird nur einmal angezeigt. Für Schlüssel muss in Ihrem Konto die Zwei-Schritt-Anmeldung aktiviert sein.
$ export NAMEOCEAN_API_KEY=no_live_… $ 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}
Mit der CLI benötigen Sie keinen Schlüssel: nameocean login meldet Sie über den Browser an. Installieren Sie sie mit brew install nameocean/tap/nameocean oder curl -fsSL https://nameocean.net/install.sh | sh.
$ nameocean login $ nameocean account
$ curl "https://nameocean.net/api/v1/domains/check?name=kahvebot.com" \ -H "Authorization: Bearer $NAMEOCEAN_API_KEY" {"name": "kahvebot.com", "available": true, "years": 1, "premium": false, "register_price": "10.99", "renew_price": "10.99", "currency": "USD"} $ nameocean domains check kahvebot.com
Die Registrierung erfolgt über POST /domains und wird mit Ihrem Kontoguthaben bezahlt, daher ist zusätzlich der Scope billing:write erforderlich. Im Rest dieser Seite wird eine Domain verwendet, die Sie bereits bei NameOcean DNS haben.
$ curl -X POST https://nameocean.net/api/v1/dns/example.com/records \ -H "Authorization: Bearer $NAMEOCEAN_API_KEY" -H "Content-Type: application/json" \ -d '{"type": "A", "hostname": "app", "ip": "203.0.113.10", "ttl": "5m"}' {"id": 4183, "type": "A", "hostname": "app", "ip": "203.0.113.10", "ttl": "5m"} $ nameocean dns add example.com A app 203.0.113.10 --ttl 5m $ dig +short app.example.com @ns1.nameocean.net 203.0.113.10
Die Nameserver liefern den neuen Eintrag innerhalb von Sekunden aus. hostname ist relativ zur Zone: @ steht für example.com selbst. Ändern Sie ihn mit PATCH /dns/example.com/records/A/4183 und löschen Sie ihn mit DELETE auf demselben Pfad.
Teilen Sie NameOcean mit, wohin DNS-Ereignisse gesendet werden sollen. Die URL muss HTTPS verwenden und öffentlich erreichbar sein; die Antwort enthält das Signatur-Secret – nur einmal.
$ curl -X POST https://nameocean.net/api/v1/webhooks \ -H "Authorization: Bearer $NAMEOCEAN_API_KEY" -H "Content-Type: application/json" \ -d '{"url": "https://example.com/hooks/nameocean", "events": ["dns.*"]}' {"id": 12, "url": "https://example.com/hooks/nameocean", "events": ["dns.*"], "active": true, "secret": "whsec_…", …} $ curl -X POST https://nameocean.net/api/v1/webhooks/12/test -H "Authorization: Bearer $NAMEOCEAN_API_KEY" {"id": "whd_…", "event": {"type": "webhook.test", …}, "status": "succeeded", "response_status": 200, …}
Ändern Sie jetzt den Eintrag aus Schritt 3, und Ihr Endpunkt erhält ein dns.record.updated-Ereignis mit dem Eintrag vorher und nachher. Prüfen Sie den Header X-NameOcean-Signature, bevor Sie einem Aufruf vertrauen: Verifizierungscode für Python, Node und Go.
Alles oben Genannte steht auch als Tool auf dem MCP-Server zur Verfügung. In Claude Code:
$ claude mcp add --transport http nameocean https://nameocean.net/mcp > Point app.example.com to 203.0.113.10 and tell me when the nameservers have it.