Met de NameOcean API kan elk programma of elke AI-assistent doen wat u in het dashboard doet: domeinen zoeken en registreren, nameservers wijzigen, DNS-records bewerken, SSL-certificaten uitgeven, poorten openen en domeinen koppelen aan uw servers.
Open Dashboard → API-sleutels, kies wat de sleutel mag doen en kopieer hem.
Plak de onderstaande prompt samen met uw sleutel in Claude, ChatGPT of Cursor.
"Laat blog.example.com naar 203.0.113.10 verwijzen en schakel SSL in."
U kunt mijn domeinen beheren met de NameOcean API. Lees https://nameocean.net/llms.txt voor een uitleg over de werking. Mijn API-sleutel is: [plak hier uw sleutel]. Vraag altijd eerst aan mij voordat iets geld kost.
Geef elke tool een eigen sleutel met alleen de rechten die deze nodig heeft. Is een sleutel uitgelekt, verwijder hem dan in het dashboard; de andere blijven gewoon werken.
NameOcean draait een externe MCP-server. Voeg deze één keer toe en uw AI kan DNS, SSL, servers, poorten en domeinkoppelingen beheren. U meldt zich aan in de browser; geen API-sleutel om te plakken en niets om te installeren.
$ claude mcp add --transport http nameocean https://nameocean.net/mcp
Claude Desktop en claude.ai: Instellingen → Connectors → Aangepaste connector toevoegen, URL https://nameocean.net/mcp.
Cursor, VS Code, OpenCode en andere: voeg een HTTP MCP-server toe met dezelfde URL.
Clients zonder OAuth kunnen verzenden Authorization: Bearer <API key>.
API-sleutels en app-koppelingen vereisen tweestapsverificatie voor uw account. Inschakelen
De MCP-server kan geen domeinen registreren of verlengen en geen tegoed toevoegen, en maakt pas een betaalde server aan nadat u akkoord bent gegaan met de prijs. Ontkoppel apps op elk moment in Dashboard → Gekoppelde apps.
De nameocean CLI doet hetzelfde vanuit uw terminal en scripts, en nameocean mcp install koppelt Claude Code, Cursor, OpenCode en VS Code voor u.
$ curl -fsSL https://nameocean.net/install.sh | sh $ nameocean login $ nameocean dns add example.com A @ 203.0.113.10
Ontvang een ondertekende POST wanneer een domein wordt geregistreerd of bijna verloopt, een DNS-record wijzigt of een certificaat wordt uitgegeven, in plaats van de API te pollen.
Verstuur transactionele e-mail vanaf uw eigen domein met afleveringsgebeurtenissen, maak mailboxen, aliassen en mailinglijsten aan, schakel gratis doorsturen in voor hier geregistreerde domeinen en ontvang inkomende mail als JSON op uw endpoint.
Stuur uw sleutel mee in de Authorization-header van elk verzoek. Antwoorden zijn in JSON. De limiet is 120 verzoeken per minuut.
$ 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}
Maak zoveel sleutels aan als u nodig hebt in Dashboard → API-sleutels, elk met alleen de rechten die de betreffende tool nodig heeft, een optionele vervaldatum en een optionele lijst met toegestane IP's. Een sleutel wordt één keer getoond; NameOcean bewaart alleen de vingerafdruk ervan.
Een sleutel kan ook worden beperkt tot een deel van uw domeinen. Hij werkt dan alleen op de endpoints van die domeinen (DNS, SSL, de instellingen van het domein, de e-mail en doorverwijzingen), ziet alleen die domeinen in GET /dns en krijgt overal elders een 403 domain_not_allowed, ook bij servers, facturatie en uw andere domeinen. Gebruik zo'n sleutel voor CI-jobs en tools zoals certbot, octoDNS of DNSControl.
account:read | E-mail en accounttegoed |
domains:read | Domeinen weergeven, beschikbaarheid en prijs controleren |
domains:write | Automatische verlenging, vergrendeling en nameservers wijzigen; de verhuiscode lezen |
dns:read | DNS-zones en -records weergeven |
dns:write | Zones aanmaken; records toevoegen, wijzigen en verwijderen |
ssl:read | Certificaatstatus |
ssl:write | Certificaten uitgeven, automatische verlenging wijzigen |
servers:read | App-servers, hun poorten en domeinen |
servers:write | Poorten openen en sluiten, domeinen koppelen en ontkoppelen |
email:read | Maildomeinen, mailboxen, aliassen, doorsturen en het bijbehorende logboek |
email:write | Mailboxen, aliassen en lijsten toevoegen en verwijderen; wachtwoorden instellen; doorsturen in- en uitschakelen |
email:send | E-mail verzenden vanuit uw mailboxen (POST /email/send) |
monitors:read | Uptime-monitors, hun status en incidenten |
monitors:write | Uptime-monitors toevoegen, wijzigen, pauzeren en verwijderen |
webhooks:read | Webhook-endpoints en hun leveringen |
webhooks:write | Webhook-endpoints toevoegen, wijzigen en verwijderen, tests versturen, leveringen opnieuw verzenden |
billing:write | Domeinen registreren en verlengen (gebruikt accounttegoed) |
GET vereist <area>:read, andere methoden <area>:write. Voor het registreren en verlengen van een domein is ook billing:write nodig; voor het koppelen van een domein aan een server ook dns:write. Een aanroep zonder de vereiste scope krijgt een 403 met required_scopes als antwoord. Dezelfde regels gelden voor de MCP-server wanneer deze met een sleutel wordt gebruikt.
Basis-URL: https://nameocean.net/api/v1/
De API-referentie bevat elk veld, elke foutcode en per endpoint een curl-voorbeeld; openapi.json kunt u importeren in Postman of Insomnia.
| GET | /domains/check?name=example.com | Beschikbaarheid en prijs |
| GET | /whois/{name} | WHOIS/RDAP-gegevens van elk domein: registrar, datums, status, nameservers |
| GET | /domains | Uw domeinen weergeven |
| POST | /domains | Een domein registreren, betaald van uw saldo {"name", "years"} |
| GET | /domains/{name} | Details, nameservers, SSL-status |
| PATCH | /domains/{name} | Automatisch verlengen en overdrachtsblokkering {"auto_renew", "locked"} |
| PUT | /domains/{name}/nameservers | {"nameservers": [...]} of "nameocean" |
| POST | /domains/{name}/renew | Een jaar verlengen (binnen 60 dagen voor de vervaldatum) |
| GET | /domains/{name}/auth-code | Overdrachtscode |
| GET | /dns | DNS-zones weergeven |
| POST | /dns | Een zone aanmaken voor een elders geregistreerd domein {"name"} |
| GET | /dns/{zone}/records | Records weergeven |
| POST | /dns/{zone}/records | Record toevoegen: A, AAAA, CNAME, MX, TXT, SRV, PTR, CAA, REDIRECT |
| PATCH | /dns/{zone}/records/{type}/{id} | Record wijzigen |
| DELETE | /dns/{zone}/records/{type}/{id} | Record verwijderen |
| POST | /dns/{zone}/plan · apply | Wijzig de hele zone vanuit een YAML- of JSON-bestand · DNS als code → |
| GET | /ssl/{zone} | Status, vervaldatum en downloadlink |
| POST | /ssl/{zone} | Gratis wildcardcertificaat uitgeven |
| PATCH | /ssl/{zone} | Automatisch verlengen {"auto_renew"} |
{server} is de server-id of het standaarddomein, zoals 3f9a1c2e.nameocean.org.
| GET | /servers | Uw servers met SSH, git remote, poorten en domeinen |
| GET | /servers/{server} | Eén server |
| GET | /servers/{server}/ports | Open poorten |
| POST | /servers/{server}/ports | Een TCP- of UDP-poort openen {"port", "protocol"} |
| DELETE | /servers/{server}/ports/{id} | Een poort sluiten |
| GET | /servers/{server}/domains | Gekoppelde domeinen en hun status |
| POST | /servers/{server}/domains | Een domein of subdomein koppelen met HTTPS {"domain"} |
| DELETE | /servers/{server}/domains/{id} | Een domein ontkoppelen |
| POST | /servers/{server}/deploys | Na git push: de apps herstarten en de deploy vastleggen |
| GET | /servers/{server}/logs | App-logs · alle server-endpoints → |
# 1. Prijs controleren curl "https://nameocean.net/api/v1/domains/check?name=kahvebot.com" -H "Authorization: Bearer $KEY" # 2. Registreren (wordt van uw saldo afgeschreven) 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. Naar uw server laten wijzen 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. Gratis wildcard SSL curl -X POST https://nameocean.net/api/v1/ssl/kahvebot.com -H "Authorization: Bearer $KEY"
De volledige referentie voor AI-agents, met alle velden en recordtypen, vindt u op nameocean.net/llms.txt. GET /api/v1/ beschrijft zichzelf ook.