24/7 Support
FAQ
 Dashbord
Kontosaldo:    

Utviklere → Hurtigstart

Hurtigstart

På fem minutter: en API-nøkkel, en sjekk av domenetilgjengelighet, en DNS-post og en webhook som varsler koden din når posten endres. Hvert trinn fungerer med curl eller nameocean CLI.

1. Skaff en nøkkel

Åpne Kontrollpanel → API-nøkler og opprett en nøkkel med account:read, domains:read, dns:write og webhooks:write. Den vises bare én gang. Nøkler krever totrinnspålogging på kontoen din.

curl
$ 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}

Med CLI-en kan du hoppe over nøkkelen: nameocean login logger deg inn via nettleseren. Installer den med brew install nameocean/tap/nameocean eller curl -fsSL https://nameocean.net/install.sh | sh.

nameocean
$ nameocean login
$ nameocean account

2. Sjekk et domene

curl
$ 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

Registrering gjøres med POST /domains og betales med kontokreditt, så det krever i tillegg tilgangsområdet billing:write. Resten av denne siden bruker et domene du allerede har på NameOcean DNS.

3. Legg til en DNS-post

curl
$ 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

Navneserverne svarer med den nye posten i løpet av sekunder. hostname er relativt til sonen: @ er selve example.com. Endre den med PATCH /dns/example.com/records/A/4183, og slett den med DELETE på samme sti.

4. Få en webhook

Fortell NameOcean hvor DNS-hendelser skal postes. URL-en må bruke HTTPS på en offentlig adresse; svaret inneholder signeringshemmeligheten, én gang.

curl
$ 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, …}

Endre nå posten fra trinn 3, så mottar endepunktet ditt en dns.record.updated-hendelse med posten før og etter. Kontroller X-NameOcean-Signature-headeren før du stoler på et kall: verifiseringskode for Python, Node og Go.

5. Eller la AI-en gjøre det

Alt ovenfor finnes også som verktøy på MCP-serveren. I Claude Code:

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.

Neste