NameOcean API lar et hvilket som helst program, eller en hvilken som helst AI-assistent, gjøre det du gjør i kontrollpanelet: søke etter og registrere domener, endre navneservere, redigere DNS-poster, utstede SSL-sertifikater, åpne porter og knytte domener til serverne dine.
Åpne Dashbord → API-nøkler, velg hva nøkkelen skal kunne gjøre, og kopier den.
Lim inn ledeteksten nedenfor i Claude, ChatGPT eller Cursor sammen med nøkkelen din.
"Pek blog.example.com til 203.0.113.10 og slå på SSL."
Du kan administrere domenene mine med NameOcean API. Les https://nameocean.net/llms.txt for å se hvordan det fungerer. API-nøkkelen min er: [lim inn nøkkelen din her]. Spør meg alltid før noe som koster penger.
Gi hvert verktøy sin egen nøkkel med bare de tillatelsene det trenger. Slett en nøkkel i dashbordet hvis den lekker; de andre fortsetter å fungere.
NameOcean driver en ekstern MCP-server. Legg den til én gang, så kan AI-en din administrere DNS, SSL, servere, porter og domenekoblinger. Du logger inn i nettleseren; ingen API-nøkkel å lime inn og ingenting å installere.
$ claude mcp add --transport http nameocean https://nameocean.net/mcp
Claude Desktop og claude.ai: Innstillinger → Koblinger → Legg til egendefinert kobling, URL https://nameocean.net/mcp.
Cursor, VS Code, OpenCode og andre: legg til en HTTP MCP-server med samme URL.
Klienter uten OAuth kan sende Authorization: Bearer <API key>.
API-nøkler og appkoblinger krever innlogging i to trinn på kontoen din. Slå på
MCP-serveren kan ikke registrere eller fornye domener eller fylle på kreditt, og oppretter en betalt server først etter at du har godtatt prisen. Du kan når som helst koble fra apper i Kontrollpanel → Tilkoblede apper.
nameocean CLI gjør det samme fra terminalen og skriptene dine, og nameocean mcp install kobler til Claude Code, Cursor, OpenCode og VS Code for deg.
$ curl -fsSL https://nameocean.net/install.sh | sh $ nameocean login $ nameocean dns add example.com A @ 203.0.113.10
Få en signert POST når et domene registreres eller snart utløper, en DNS-post endres eller et sertifikat utstedes, i stedet for å spørre API-et gjentatte ganger.
Send transaksjonell e-post fra ditt eget domene med leveringshendelser, opprett postkasser, aliaser og e-postlister, slå på gratis videresending for domener registrert her, og motta innkommende e-post på endepunktet ditt som JSON.
Send nøkkelen din i Authorization-headeren i hver forespørsel. Svarene er i JSON. Grensen er 120 forespørsler per minutt.
$ 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}
Opprett så mange nøkler du trenger i Kontrollpanel → API-nøkler, hver med kun de tillatelsene verktøyet trenger, en valgfri utløpsdato og en valgfri liste over tillatte IP-adresser. En nøkkel vises bare én gang; NameOcean lagrer kun fingeravtrykket.
En nøkkel kan også begrenses til noen av domenene dine. Den fungerer da bare på endepunktene for disse domenene (DNS, SSL, domenets innstillinger, e-post og videresending), ser bare dem i GET /dns, og får 403 domain_not_allowed alle andre steder, inkludert servere, fakturering og de andre domenene dine. Bruk en slik nøkkel for CI-jobber og verktøy som certbot, octoDNS eller DNSControl.
account:read | E-post og kontokreditt |
domains:read | Vis domener, sjekk tilgjengelighet og pris |
domains:write | Endre automatisk fornyelse, lås og navnetjenere; les overføringskoden |
dns:read | Vis DNS-soner og -poster |
dns:write | Opprett soner; legg til, endre og slett poster |
ssl:read | Sertifikatstatus |
ssl:write | Utsted sertifikater, endre automatisk fornyelse |
servers:read | Appservere, portene og domenene deres |
servers:write | Åpne og lukk porter, koble domener til og fra |
email:read | E-postdomener, postbokser, aliaser, videresending og loggen for den |
email:write | Legg til og slett postbokser, aliaser og lister; angi passord; slå videresending på og av |
email:send | Send e-post fra postkassene dine (POST /email/send) |
monitors:read | Oppetidsmonitorer, status og hendelser |
monitors:write | Legg til, endre, sett på pause og slett oppetidsmonitorer |
webhooks:read | Webhook-endepunkter og leveransene deres |
webhooks:write | Legg til, endre og slett webhook-endepunkter, send tester og send leveranser på nytt |
billing:write | Registrer og forny domener (bruker kontokreditt) |
GET krever <area>:read, andre metoder <area>:write. Registrering og fornyelse av et domene krever også billing:write; å knytte et domene til en server krever også dns:write. Et kall uten nødvendig scope besvares med 403 og required_scopes. De samme reglene gjelder for MCP-serveren når den brukes med en nøkkel.
Basis-URL: https://nameocean.net/api/v1/
API-referansen inneholder alle felt, feilkoder og et curl-eksempel per endepunkt; openapi.json kan importeres i Postman eller Insomnia.
| GET | /domains/check?name=example.com | Tilgjengelighet og pris |
| GET | /whois/{name} | WHOIS/RDAP-data for alle domener: registrar, datoer, status, navneservere |
| GET | /domains | List opp domenene dine |
| POST | /domains | Registrer et domene, betalt fra saldoen din {"name", "years"} |
| GET | /domains/{name} | Detaljer, navneservere, SSL-status |
| PATCH | /domains/{name} | Automatisk fornyelse og overføringslås {"auto_renew", "locked"} |
| PUT | /domains/{name}/nameservers | {"nameservers": [...]} eller "nameocean" |
| POST | /domains/{name}/renew | Forny ett år (innen 60 dager før utløp) |
| GET | /domains/{name}/auth-code | Overføringskode |
| GET | /dns | List opp DNS-soner |
| POST | /dns | Opprett en sone for et domene registrert hos en annen leverandør {"name"} |
| GET | /dns/{zone}/records | List opp poster |
| POST | /dns/{zone}/records | Legg til en post: A, AAAA, CNAME, MX, TXT, SRV, PTR, CAA, REDIRECT |
| PATCH | /dns/{zone}/records/{type}/{id} | Endre en post |
| DELETE | /dns/{zone}/records/{type}/{id} | Slett en post |
| POST | /dns/{zone}/plan · apply | Endre hele sonen fra en YAML- eller JSON-fil · DNS som kode → |
| GET | /ssl/{zone} | Status, utløpsdato og nedlastingslenke |
| POST | /ssl/{zone} | Utsted et gratis wildcard-sertifikat |
| PATCH | /ssl/{zone} | Automatisk fornyelse {"auto_renew"} |
{server} er server-ID-en eller standarddomenet til serveren, for eksempel 3f9a1c2e.nameocean.org.
| GET | /servers | Serverne dine med SSH, git remote, porter og domener |
| GET | /servers/{server} | Én server |
| GET | /servers/{server}/ports | Åpne porter |
| POST | /servers/{server}/ports | Åpne en TCP- eller UDP-port {"port", "protocol"} |
| DELETE | /servers/{server}/ports/{id} | Lukk en port |
| GET | /servers/{server}/domains | Tilknyttede domener og status |
| POST | /servers/{server}/domains | Knytt et domene eller underdomene til med HTTPS {"domain"} |
| DELETE | /servers/{server}/domains/{id} | Fjern tilknytningen til et domene |
| POST | /servers/{server}/deploys | Etter git push: start appene på nytt og registrer utrullingen |
| GET | /servers/{server}/logs | App-logger · alle server-endepunkter → |
# 1. Sjekk prisen curl "https://nameocean.net/api/v1/domains/check?name=kahvebot.com" -H "Authorization: Bearer $KEY" # 2. Registrer (belaster saldoen din) 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. Pek det til serveren din 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"
Den fullstendige referansen for AI-agenter, med alle felt og posttyper, finnes på nameocean.net/llms.txt. GET /api/v1/ beskriver seg også selv.