L'API di NameOcean consente a qualsiasi programma, o assistente AI, di fare ciò che Lei fa nella dashboard: cercare e registrare domini, cambiare i nameserver, modificare i record DNS, emettere certificati SSL, aprire porte e collegare i domini ai Suoi server.
Apra Dashboard → Chiavi API, scelga cosa può fare la chiave e la copi.
Incolli il prompt qui sotto in Claude, ChatGPT o Cursor insieme alla Sua chiave.
"Punta blog.example.com a 203.0.113.10 e attiva SSL."
Puoi gestire i miei domini con l'API di NameOcean. Leggi https://nameocean.net/llms.txt per scoprire come funziona. La mia chiave API è: [incolla qui la tua chiave]. Chiedimi sempre prima di qualsiasi operazione che comporti un costo.
Assegni a ogni strumento una chiave dedicata con i soli permessi necessari. Se una chiave viene compromessa, la elimini dalla dashboard: le altre continuano a funzionare.
NameOcean offre un server MCP remoto. Lo aggiunga una volta sola e la Sua AI potrà gestire DNS, SSL, server, porte e collegamenti dei domini. Accede dal browser; nessuna chiave API da incollare e nulla da installare.
$ claude mcp add --transport http nameocean https://nameocean.net/mcp
Claude Desktop e claude.ai: Impostazioni → Connettori → Aggiungi connettore personalizzato, URL https://nameocean.net/mcp.
Cursor, VS Code, OpenCode e altri: aggiunga un server MCP HTTP con lo stesso URL.
I client senza OAuth possono inviare Authorization: Bearer <API key>.
Le chiavi API e le connessioni delle app richiedono l'accesso in due passaggi sul Suo account. Attivalo
Il server MCP non può registrare o rinnovare domini né aggiungere credito, e crea un server a pagamento solo dopo che Lei ha accettato il prezzo. Può disconnettere le app in qualsiasi momento in Dashboard → App collegate.
La CLI nameocean fa lo stesso dal Suo terminale e dai Suoi script, e nameocean mcp install collega per Lei Claude Code, Cursor, OpenCode e VS Code.
$ curl -fsSL https://nameocean.net/install.sh | sh $ nameocean login $ nameocean dns add example.com A @ 203.0.113.10
Riceva un POST firmato quando un dominio viene registrato o sta per scadere, un record DNS cambia o viene emesso un certificato, senza dover interrogare periodicamente l'API.
Invii email transazionali dal Suo dominio con eventi di consegna, crei caselle di posta, alias e mailing list, attivi l'inoltro gratuito per i domini registrati qui e riceva la posta in arrivo sul Suo endpoint in formato JSON.
Invii la Sua chiave nell'header Authorization di ogni richiesta. Le risposte sono in formato JSON. Il limite è di 120 richieste al minuto.
$ 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}
Crei tutte le chiavi di cui ha bisogno in Dashboard → Chiavi API, ciascuna con i soli permessi necessari al proprio strumento, una data di scadenza facoltativa e un elenco facoltativo di IP consentiti. Una chiave viene mostrata una sola volta; NameOcean ne conserva solo l'impronta.
Una chiave può anche essere limitata ad alcuni dei Suoi domini. In tal caso funziona solo sugli endpoint di quei domini (DNS, SSL, impostazioni del dominio, relativa email e inoltro), vede solo quelli in GET /dns e riceve un 403 domain_not_allowed in qualsiasi altro punto, inclusi server, fatturazione e gli altri Suoi domini. La utilizzi per job CI e strumenti come certbot, octoDNS o DNSControl.
account:read | Email e credito dell'account |
domains:read | Elencare i domini, verificarne disponibilità e prezzo |
domains:write | Modificare rinnovo automatico, blocco e nameserver; leggere il codice di trasferimento |
dns:read | Elencare zone e record DNS |
dns:write | Creare zone; aggiungere, modificare ed eliminare record |
ssl:read | Stato dei certificati |
ssl:write | Emettere certificati, modificare il rinnovo automatico |
servers:read | Server applicativi, relative porte e domini |
servers:write | Aprire e chiudere porte, associare e dissociare domini |
email:read | Domini di posta, caselle, alias, inoltro e relativo log |
email:write | Aggiunga ed elimini caselle, alias e liste; imposti password; attivi e disattivi l'inoltro |
email:send | Invia email dalle tue caselle di posta (POST /email/send) |
monitors:read | Monitor di uptime, relativo stato e incidenti |
monitors:write | Aggiungere, modificare, sospendere ed eliminare i monitor di uptime |
webhooks:read | Endpoint webhook e relative consegne |
webhooks:write | Aggiunga, modifichi ed elimini endpoint webhook, invii test, reinvii consegne |
billing:write | Registrare e rinnovare domini (utilizza il credito dell'account) |
GET richiede <area>:read, gli altri metodi <area>:write. La registrazione e il rinnovo di un dominio richiedono anche billing:write; il collegamento di un dominio a un server richiede anche dns:write. Una chiamata senza lo scope risponde 403 con required_scopes. Le stesse regole si applicano al server MCP quando viene usato con una chiave.
URL di base: https://nameocean.net/api/v1/
Il riferimento API riporta ogni campo, codice di errore e un esempio curl per ciascun endpoint; openapi.json si importa in Postman o Insomnia.
| GET | /domains/check?name=example.com | Disponibilità e prezzo |
| GET | /whois/{name} | Dati WHOIS/RDAP di qualsiasi dominio: registrar, date, stato, nameserver |
| GET | /domains | Elenca i Suoi domini |
| POST | /domains | Registra un dominio, pagato dal Suo saldo {"name", "years"} |
| GET | /domains/{name} | Dettagli, nameserver, stato SSL |
| PATCH | /domains/{name} | Rinnovo automatico e blocco del trasferimento {"auto_renew", "locked"} |
| PUT | /domains/{name}/nameservers | {"nameservers": [...]} o "nameocean" |
| POST | /domains/{name}/renew | Rinnova per un anno (entro 60 giorni dalla scadenza) |
| GET | /domains/{name}/auth-code | Codice di trasferimento |
| GET | /dns | Elenca le zone DNS |
| POST | /dns | Crea una zona per un dominio registrato altrove {"name"} |
| GET | /dns/{zone}/records | Elenca i record |
| POST | /dns/{zone}/records | Aggiungere un record: A, AAAA, CNAME, MX, TXT, SRV, PTR, CAA, REDIRECT |
| PATCH | /dns/{zone}/records/{type}/{id} | Modificare un record |
| DELETE | /dns/{zone}/records/{type}/{id} | Eliminare un record |
| POST | /dns/{zone}/plan · apply | Modifica l'intera zona da un file YAML o JSON · DNS as code → |
| GET | /ssl/{zone} | Stato, data di scadenza e link per il download |
| POST | /ssl/{zone} | Emettere un certificato wildcard gratuito |
| PATCH | /ssl/{zone} | Rinnovo automatico {"auto_renew"} |
{server} è l'ID del server o il suo dominio predefinito, ad esempio 3f9a1c2e.nameocean.org.
| GET | /servers | I Suoi server con SSH, git remote, porte e domini |
| GET | /servers/{server} | Un singolo server |
| GET | /servers/{server}/ports | Porte aperte |
| POST | /servers/{server}/ports | Aprire una porta TCP o UDP {"port", "protocol"} |
| DELETE | /servers/{server}/ports/{id} | Chiudere una porta |
| GET | /servers/{server}/domains | Domini associati e relativo stato |
| POST | /servers/{server}/domains | Associare un dominio o sottodominio con HTTPS {"domain"} |
| DELETE | /servers/{server}/domains/{id} | Dissociare un dominio |
| POST | /servers/{server}/deploys | Dopo git push: riavvia le app e registra il deploy |
| GET | /servers/{server}/logs | Log delle app · tutti gli endpoint dei server → |
# 1. Verificare il prezzo curl "https://nameocean.net/api/v1/domains/check?name=kahvebot.com" -H "Authorization: Bearer $KEY" # 2. Registrare (addebita sul Suo saldo) 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. Puntarlo al Suo server 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. SSL wildcard gratuito curl -X POST https://nameocean.net/api/v1/ssl/kahvebot.com -H "Authorization: Bearer $KEY"
La documentazione completa per gli agenti AI, con ogni campo e tipo di record, è disponibile su nameocean.net/llms.txt. Anche GET /api/v1/ si autodescrive.