Support 24h/24 et 7j/7
FAQ
 Tableau de Bord
Solde du compte :    

Développeurs → Démarrage rapide

Démarrage rapide

En cinq minutes : une clé API, une vérification de disponibilité de domaine, un enregistrement DNS et un webhook qui prévient votre code lorsque l'enregistrement change. Chaque étape fonctionne avec curl ou la CLI nameocean.

1. Obtenir une clé

Ouvrez Tableau de bord → Clés API et créez une clé avec account:read, domains:read, dns:write et webhooks:write. Elle ne s'affiche qu'une seule fois. Les clés nécessitent l'activation de la connexion en deux étapes sur votre compte.

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}

Avec la CLI, vous pouvez vous passer de clé : nameocean login vous connecte via le navigateur. Installez-la avec brew install nameocean/tap/nameocean ou curl -fsSL https://nameocean.net/install.sh | sh.

nameocean
$ nameocean login
$ nameocean account

2. Vérifier un domaine

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

L'enregistrement se fait avec POST /domains et est payé avec le crédit du compte : il nécessite donc aussi la portée billing:write. La suite de cette page utilise un domaine que vous avez déjà sur le DNS NameOcean.

3. Ajouter un enregistrement 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

Les serveurs de noms renvoient le nouvel enregistrement en quelques secondes. hostname est relatif à la zone : @ correspond à example.com lui-même. Modifiez-le avec PATCH /dns/example.com/records/A/4183 et supprimez-le avec DELETE sur le même chemin.

4. Recevoir un webhook

Indiquez à NameOcean où envoyer les événements DNS. L'URL doit être en HTTPS sur une adresse publique ; la réponse contient le secret de signature, affiché une seule fois.

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

Modifiez maintenant l'enregistrement de l'étape 3 : votre endpoint reçoit un événement dns.record.updated avec l'enregistrement avant et après. Vérifiez l'en-tête X-NameOcean-Signature avant de faire confiance à un appel : code de vérification pour Python, Node et Go.

5. Ou laissez votre IA s'en charger

Tout ce qui précède est aussi disponible comme outil sur le serveur MCP. Dans 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.

Suivant