Black Friday: ricarica il saldo e ricevi il doppio del credito, fino a $50 gratis ($25 → $50, $50 → $100). Usalo per tutto: domini, hosting, email. Codice: BLACKFRIDAY2026 Ottieni credito doppio →

Dia alla Sua AI una sola chiave. Ai domini pensa lei.

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.

  1. 1

    Crea una chiave

    Apra Dashboard → Chiavi API, scelga cosa può fare la chiave e la copi.

  2. 2

    Fornisci alla tua AI

    Incolli il prompt qui sotto in Claude, ChatGPT o Cursor insieme alla Sua chiave.

  3. 3

    Chieda con parole semplici

    "Punta blog.example.com a 203.0.113.10 e attiva SSL."

Prompt per il Suo assistente AI

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.

Colleghi Claude Code, Cursor o qualsiasi client MCP

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 Code
$ 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.

Configurazione per ogni client e tutti gli strumenti →

Riga di comando

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.

nameocean
$ curl -fsSL https://nameocean.net/install.sh | sh
$ nameocean login
$ nameocean dns add example.com A @ 203.0.113.10

Opzioni di installazione e tutti i comandi →

Webhooks

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.

Eventi, payload e verifica della firma →

Email

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.

Guida all'API Email →

Autenticazione

Invii la Sua chiave nell'header Authorization di ogni richiesta. Le risposte sono in formato JSON. Il limite è di 120 richieste al minuto.

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

Permessi delle chiavi (scope)

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:readEmail e credito dell'account
domains:readElencare i domini, verificarne disponibilità e prezzo
domains:writeModificare rinnovo automatico, blocco e nameserver; leggere il codice di trasferimento
dns:readElencare zone e record DNS
dns:writeCreare zone; aggiungere, modificare ed eliminare record
ssl:readStato dei certificati
ssl:writeEmettere certificati, modificare il rinnovo automatico
servers:readServer applicativi, relative porte e domini
servers:writeAprire e chiudere porte, associare e dissociare domini
email:readDomini di posta, caselle, alias, inoltro e relativo log
email:writeAggiunga ed elimini caselle, alias e liste; imposti password; attivi e disattivi l'inoltro
email:sendInvia email dalle tue caselle di posta (POST /email/send)
monitors:readMonitor di uptime, relativo stato e incidenti
monitors:writeAggiungere, modificare, sospendere ed eliminare i monitor di uptime
webhooks:readEndpoint webhook e relative consegne
webhooks:writeAggiunga, modifichi ed elimini endpoint webhook, invii test, reinvii consegne
billing:writeRegistrare 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.

Endpoint

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.

Domini

GET/domains/check?name=example.comDisponibilità e prezzo
GET/whois/{name}Dati WHOIS/RDAP di qualsiasi dominio: registrar, date, stato, nameserver
GET/domainsElenca i Suoi domini
POST/domainsRegistra 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}/renewRinnova per un anno (entro 60 giorni dalla scadenza)
GET/domains/{name}/auth-codeCodice di trasferimento

DNS

GET/dnsElenca le zone DNS
POST/dnsCrea una zona per un dominio registrato altrove {"name"}
GET/dns/{zone}/recordsElenca i record
POST/dns/{zone}/recordsAggiungere 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 · applyModifica l'intera zona da un file YAML o JSON · DNS as code →

SSL

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 di app

{server} è l'ID del server o il suo dominio predefinito, ad esempio 3f9a1c2e.nameocean.org.

GET/serversI Suoi server con SSH, git remote, porte e domini
GET/servers/{server}Un singolo server
GET/servers/{server}/portsPorte aperte
POST/servers/{server}/portsAprire una porta TCP o UDP {"port", "protocol"}
DELETE/servers/{server}/ports/{id}Chiudere una porta
GET/servers/{server}/domainsDomini associati e relativo stato
POST/servers/{server}/domainsAssociare un dominio o sottodominio con HTTPS {"domain"}
DELETE/servers/{server}/domains/{id}Dissociare un dominio
POST/servers/{server}/deploysDopo git push: riavvia le app e registra il deploy
GET/servers/{server}/logsLog delle app · tutti gli endpoint dei server →

Esempio: nuovo dominio con HTTPS

bash
# 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.