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.
Ouvrez Tableau de bord → Clés API, choisissez ce que la clé est autorisée à faire et copiez-la.
Collez le prompt ci-dessous dans Claude, ChatGPT ou Cursor avec votre clé.
"Fais pointer blog.example.com vers 203.0.113.10 et active le SSL."
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.
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 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 →
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.
$ curl -fsSL https://nameocean.net/install.sh | sh $ nameocean login $ nameocean dns add example.com A @ 203.0.113.10
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.
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.
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 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}
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:read | E-mail et crédit du compte |
domains:read | Lister les domaines, vérifier la disponibilité et le prix |
domains:write | Modifier le renouvellement automatique, le verrouillage et les serveurs de noms ; lire le code de transfert |
dns:read | Lister les zones et les enregistrements DNS |
dns:write | Créer des zones ; ajouter, modifier et supprimer des enregistrements |
ssl:read | État des certificats |
ssl:write | Émettre des certificats, modifier le renouvellement automatique |
servers:read | Serveurs d'applications, leurs ports et domaines |
servers:write | Ouvrir et fermer des ports, associer et dissocier des domaines |
email:read | Domaines de messagerie, boîtes mail, alias, redirection et son journal |
email:write | Ajouter et supprimer des boîtes mail, des alias et des listes ; définir des mots de passe ; activer et désactiver la redirection |
email:send | Envoyer des e-mails depuis vos boîtes mail (POST /email/send) |
monitors:read | Moniteurs de disponibilité, leur statut et leurs incidents |
monitors:write | Ajouter, modifier, suspendre et supprimer des moniteurs de disponibilité |
webhooks:read | Endpoints de webhook et leurs livraisons |
webhooks:write | Ajouter, modifier et supprimer des endpoints de webhook, envoyer des tests, renvoyer des livraisons |
billing:write | Enregistrer 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é.
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.
| GET | /domains/check?name=example.com | Disponibilité et prix |
| GET | /whois/{name} | Données WHOIS/RDAP de n'importe quel domaine : registrar, dates, statut, serveurs de noms |
| GET | /domains | Lister vos domaines |
| POST | /domains | Enregistrer 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}/renew | Renouveler pour un an (dans les 60 jours précédant l'expiration) |
| GET | /domains/{name}/auth-code | Code de transfert |
| GET | /dns | Lister les zones DNS |
| POST | /dns | Créer une zone pour un domaine enregistré ailleurs {"name"} |
| GET | /dns/{zone}/records | Lister les enregistrements |
| POST | /dns/{zone}/records | Ajouter 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 · apply | Modifier toute la zone à partir d'un fichier YAML ou JSON · DNS as code → |
| 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"} |
{server} est l'identifiant du serveur ou son domaine par défaut, par exemple 3f9a1c2e.nameocean.org.
| GET | /servers | Vos serveurs avec SSH, dépôt git distant, ports et domaines |
| GET | /servers/{server} | Un serveur |
| GET | /servers/{server}/ports | Ports ouverts |
| POST | /servers/{server}/ports | Ouvrir un port TCP ou UDP {"port", "protocol"} |
| DELETE | /servers/{server}/ports/{id} | Fermer un port |
| GET | /servers/{server}/domains | Domaines liés et leur statut |
| POST | /servers/{server}/domains | Lier un domaine ou un sous-domaine avec HTTPS {"domain"} |
| DELETE | /servers/{server}/domains/{id} | Dissocier un domaine |
| POST | /servers/{server}/deploys | Après git push : redémarrer les applications et enregistrer le déploiement |
| GET | /servers/{server}/logs | Logs des applications · tous les endpoints serveur → |
# 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.