Soporte 24/7
Preguntas Frecuentes
 Panel de control
Saldo de Cuenta:    

Desarrolladores → Inicio rápido

Inicio rápido

En cinco minutos: una clave de API, una comprobación de disponibilidad de dominio, un registro DNS y un webhook que avisa a su código cuando el registro cambia. Cada paso funciona con curl o con la CLI nameocean.

1. Obtenga una clave

Abra Panel → Claves de API y cree una clave con account:read, domains:read, dns:write y webhooks:write. Solo se muestra una vez. Las claves requieren tener activado el inicio de sesión en dos pasos en su cuenta.

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}

Con la CLI puede prescindir de la clave: nameocean login inicia sesión a través del navegador. Instálela con brew install nameocean/tap/nameocean o curl -fsSL https://nameocean.net/install.sh | sh.

nameocean
$ nameocean login
$ nameocean account

2. Compruebe un dominio

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

El registro se hace con POST /domains y se paga con el saldo de la cuenta, por lo que también requiere el ámbito billing:write. El resto de esta página utiliza un dominio que ya tenga en el DNS de NameOcean.

3. Añada un registro DNS

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

Los servidores de nombres responden con el nuevo registro en cuestión de segundos. hostname es relativo a la zona: @ es el propio example.com. Modifíquelo con PATCH /dns/example.com/records/A/4183 y elimínelo con DELETE en la misma ruta.

4. Reciba un webhook

Indique a NameOcean dónde enviar los eventos de DNS. La URL debe ser HTTPS y estar en una dirección pública; la respuesta incluye el secreto de firma, una sola vez.

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

Ahora modifique el registro del paso 3 y su endpoint recibirá un evento dns.record.updated con el registro antes y después del cambio. Verifique la cabecera X-NameOcean-Signature antes de confiar en una llamada: código de verificación para Python, Node y Go.

5. O deje que lo haga su IA

Todo lo anterior también está disponible como herramienta en el servidor MCP. En 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.

Siguiente