Black Friday : rechargez votre compte et recevez le double en crédit, jusqu'à $50 offerts ($25 → $50, $50 → $100). Utilisable pour tout : domaines, hébergement, e-mail. Code : BLACKFRIDAY2026 Obtenez 2x plus de crédit →

Donnez une seule clé à votre IA. Elle s'occupe de vos domaines.

L'API NameOcean permet à n'importe quel programme, ou à n'importe quel assistant IA, de faire ce que vous faites dans le tableau de bord : rechercher et enregistrer des domaines, modifier les serveurs de noms, éditer les enregistrements DNS, émettre des certificats SSL, ouvrir des ports et associer des domaines à vos serveurs.

  1. 1

    Créer une clé

    Ouvrez Tableau de bord → Clés API, choisissez ce que la clé est autorisée à faire et copiez-la.

  2. 2

    Confiez-le à votre IA

    Collez le prompt ci-dessous dans Claude, ChatGPT ou Cursor avec votre clé.

  3. 3

    Demandez avec des mots simples

    "Fais pointer blog.example.com vers 203.0.113.10 et active le SSL."

Prompt pour votre assistant IA

Vous pouvez gérer mes domaines avec l'API NameOcean. Lisez https://nameocean.net/llms.txt pour comprendre son fonctionnement. Ma clé API est : [collez votre clé ici]. Demandez-moi toujours avant toute action payante.

Attribuez à chaque outil sa propre clé, avec uniquement les permissions dont il a besoin. Si une clé fuite, supprimez-la dans le tableau de bord ; les autres continuent de fonctionner.

Connectez Claude Code, Cursor ou tout client MCP

NameOcean propose un serveur MCP distant. Ajoutez-le une seule fois et votre IA pourra gérer le DNS, le SSL, les serveurs, les ports et les associations de domaines. Vous vous connectez dans le navigateur ; aucune clé API à coller et rien à installer.

Claude Code
$ claude mcp add --transport http nameocean https://nameocean.net/mcp

Claude Desktop et claude.ai : Paramètres → Connecteurs → Ajouter un connecteur personnalisé, URL https://nameocean.net/mcp. Cursor, VS Code, OpenCode et autres : ajoutez un serveur MCP HTTP avec la même URL. Les clients sans OAuth peuvent envoyer Authorization: Bearer <API key>.

Les clés API et les connexions d'applications nécessitent la connexion en deux étapes sur votre compte. Activer

Le serveur MCP ne peut ni enregistrer ni renouveler de domaines, ni ajouter de crédit, et ne crée un serveur payant qu'après votre accord sur le prix. Vous pouvez déconnecter des applications à tout moment dans Tableau de bord → Applications connectées.

Configuration de chaque client et liste de tous les outils →

Ligne de commande

La CLI nameocean fait de même depuis votre terminal et vos scripts, et nameocean mcp install connecte Claude Code, Cursor, OpenCode et VS Code pour vous.

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

Options d'installation et toutes les commandes →

Webhooks

Recevez un POST signé lorsqu'un domaine est enregistré ou sur le point d'expirer, qu'un enregistrement DNS change ou qu'un certificat est émis, au lieu d'interroger l'API en boucle.

Événements, payloads et vérification de la signature →

E-mail

Envoyez des e-mails transactionnels depuis votre propre domaine avec les événements de livraison, créez des boîtes mail, des alias et des listes de diffusion, activez la redirection gratuite pour les domaines enregistrés ici et recevez le courrier entrant sur votre endpoint au format JSON.

Guide de l'API E-mail →

Authentification

Envoyez votre clé dans l'en-tête Authorization de chaque requête. Les réponses sont au format JSON. La limite est de 120 requêtes par minute.

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}

Permissions des clés (scopes)

Créez autant de clés que nécessaire dans Tableau de bord → Clés API, chacune avec uniquement les permissions dont son outil a besoin, une date d'expiration facultative et une liste facultative d'IP autorisées. Une clé n'est affichée qu'une seule fois ; NameOcean n'en conserve que l'empreinte.

Une clé peut aussi être limitée à certains de vos domaines. Elle ne fonctionne alors que sur les endpoints de ces domaines (DNS, SSL, paramètres du domaine, messagerie et redirection), ne voit qu'eux dans GET /dns et reçoit une erreur 403 domain_not_allowed partout ailleurs, y compris pour les serveurs, la facturation et vos autres domaines. Utilisez-en une pour les tâches CI et les outils comme certbot, octoDNS ou DNSControl.

account:readE-mail et crédit du compte
domains:readLister les domaines, vérifier la disponibilité et le prix
domains:writeModifier le renouvellement automatique, le verrouillage et les serveurs de noms ; lire le code de transfert
dns:readLister les zones et les enregistrements DNS
dns:writeCréer des zones ; ajouter, modifier et supprimer des enregistrements
ssl:readÉtat des certificats
ssl:writeÉmettre des certificats, modifier le renouvellement automatique
servers:readServeurs d'applications, leurs ports et domaines
servers:writeOuvrir et fermer des ports, associer et dissocier des domaines
email:readDomaines de messagerie, boîtes mail, alias, redirection et son journal
email:writeAjouter et supprimer des boîtes mail, des alias et des listes ; définir des mots de passe ; activer et désactiver la redirection
email:sendEnvoyer des e-mails depuis vos boîtes mail (POST /email/send)
monitors:readMoniteurs de disponibilité, leur statut et leurs incidents
monitors:writeAjouter, modifier, suspendre et supprimer des moniteurs de disponibilité
webhooks:readEndpoints de webhook et leurs livraisons
webhooks:writeAjouter, modifier et supprimer des endpoints de webhook, envoyer des tests, renvoyer des livraisons
billing:writeEnregistrer et renouveler des domaines (utilise le crédit du compte)

Les requêtes GET nécessitent <area>:read, les autres méthodes <area>:write. L'enregistrement et le renouvellement d'un domaine nécessitent aussi billing:write ; l'association d'un domaine à un serveur nécessite aussi dns:write. Un appel sans le scope requis renvoie une erreur 403 avec required_scopes. Les mêmes règles s'appliquent au serveur MCP lorsqu'il est utilisé avec une clé.

Points de terminaison

URL de base: https://nameocean.net/api/v1/

La référence de l'API détaille chaque champ, chaque code d'erreur et fournit un exemple curl par endpoint ; openapi.json s'importe dans Postman ou Insomnia.

Domaines

GET/domains/check?name=example.comDisponibilité et prix
GET/whois/{name}Données WHOIS/RDAP de n'importe quel domaine : registrar, dates, statut, serveurs de noms
GET/domainsLister vos domaines
POST/domainsEnregistrer un domaine, payé depuis votre solde {"name", "years"}
GET/domains/{name}Détails, serveurs de noms, statut SSL
PATCH/domains/{name}Renouvellement automatique et verrouillage de transfert {"auto_renew", "locked"}
PUT/domains/{name}/nameservers{"nameservers": [...]} ou "nameocean"
POST/domains/{name}/renewRenouveler pour un an (dans les 60 jours précédant l'expiration)
GET/domains/{name}/auth-codeCode de transfert

DNS

GET/dnsLister les zones DNS
POST/dnsCréer une zone pour un domaine enregistré ailleurs {"name"}
GET/dns/{zone}/recordsLister les enregistrements
POST/dns/{zone}/recordsAjouter un enregistrement: A, AAAA, CNAME, MX, TXT, SRV, PTR, CAA, REDIRECT
PATCH/dns/{zone}/records/{type}/{id}Modifier un enregistrement
DELETE/dns/{zone}/records/{type}/{id}Supprimer un enregistrement
POST/dns/{zone}/plan · applyModifier toute la zone à partir d'un fichier YAML ou JSON · DNS as code →

SSL

GET/ssl/{zone}Statut, date d'expiration et lien de téléchargement
POST/ssl/{zone}Émettre un certificat wildcard gratuit
PATCH/ssl/{zone}Renouvellement automatique {"auto_renew"}

Serveurs d'applications

{server} est l'identifiant du serveur ou son domaine par défaut, par exemple 3f9a1c2e.nameocean.org.

GET/serversVos serveurs avec SSH, dépôt git distant, ports et domaines
GET/servers/{server}Un serveur
GET/servers/{server}/portsPorts ouverts
POST/servers/{server}/portsOuvrir un port TCP ou UDP {"port", "protocol"}
DELETE/servers/{server}/ports/{id}Fermer un port
GET/servers/{server}/domainsDomaines liés et leur statut
POST/servers/{server}/domainsLier un domaine ou un sous-domaine avec HTTPS {"domain"}
DELETE/servers/{server}/domains/{id}Dissocier un domaine
POST/servers/{server}/deploysAprès git push : redémarrer les applications et enregistrer le déploiement
GET/servers/{server}/logsLogs des applications · tous les endpoints serveur →

Exemple : nouveau domaine avec HTTPS

bash
# 1. Vérifier le prix
curl "https://nameocean.net/api/v1/domains/check?name=kahvebot.com" -H "Authorization: Bearer $KEY"

# 2. Enregistrer (débite votre solde)
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. Le faire pointer vers votre serveur
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 gratuit
curl -X POST https://nameocean.net/api/v1/ssl/kahvebot.com -H "Authorization: Bearer $KEY"

La référence complète pour les agents IA, avec tous les champs et types d'enregistrements, est disponible sur nameocean.net/llms.txt. GET /api/v1/ se décrit également lui-même.