24/7 ondersteuning
Veelgestelde vragen
 Dashboard
Accountsaldo:    

Ontwikkelaars → Snelstart

Snelstart

In vijf minuten: een API-sleutel, een controle op beschikbaarheid van een domein, een DNS-record en een webhook die uw code laat weten wanneer het record verandert. Elke stap werkt met curl of de nameocean CLI.

1. Sleutel aanmaken

Open Dashboard → API-sleutels en maak een sleutel aan met account:read, domains:read, dns:write en webhooks:write. Deze wordt eenmalig getoond. Voor sleutels moet inloggen in twee stappen op uw account zijn ingeschakeld.

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}

Met de CLI kunt u de sleutel overslaan: nameocean login meldt u aan via de browser. Installeer de CLI met brew install nameocean/tap/nameocean of curl -fsSL https://nameocean.net/install.sh | sh.

nameocean
$ nameocean login
$ nameocean account

2. Domein controleren

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

Registreren gaat via POST /domains en wordt betaald uit uw accounttegoed, dus daarvoor is ook de scope billing:write nodig. De rest van deze pagina gebruikt een domein dat u al op NameOcean DNS hebt.

3. DNS-record toevoegen

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

De nameservers geven binnen enkele seconden het nieuwe record terug. hostname is relatief ten opzichte van de zone: @ is example.com zelf. Wijzig het record met PATCH /dns/example.com/records/A/4183 en verwijder het met DELETE op hetzelfde pad.

4. Webhook ontvangen

Geef aan waar NameOcean DNS-events naartoe moet sturen. De URL moet HTTPS zijn op een openbaar adres; het antwoord bevat eenmalig het ondertekeningsgeheim.

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

Wijzig nu het record uit stap 3 en uw endpoint ontvangt een dns.record.updated-event met het record vóór en na de wijziging. Controleer de header X-NameOcean-Signature voordat u een aanroep vertrouwt: verificatiecode voor Python, Node en Go.

5. Of laat uw AI het doen

Alles hierboven is ook beschikbaar als tool op de MCP-server. In 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.

Volgende