NameOcean API umožňuje jakémukoli programu nebo asistentovi AI udělat to, co děláte v ovládacím panelu: vyhledávat a registrovat domény, měnit nameservery, upravovat DNS záznamy, vydávat certifikáty SSL, otevírat porty a přiřazovat domény ke svým serverům.
Otevřete Nástěnka → API klíče, zvolte, co smí klíč dělat, a zkopírujte jej.
Vložte níže uvedený prompt do aplikací Claude, ChatGPT nebo Cursor spolu se svým klíčem.
"Nasměrujte blog.example.com na 203.0.113.10 a zapněte SSL."
Můžete spravovat moje domény pomocí NameOcean API. Přečtěte si https://nameocean.net/llms.txt, jak to funguje. Můj API klíč je: [sem vložte svůj klíč]. Před čímkoli, co stojí peníze, se mě vždy zeptejte.
Každému nástroji dejte vlastní klíč pouze s oprávněními, která potřebuje. Pokud klíč unikne, smažte jej v nástěnce; ostatní budou fungovat dál.
NameOcean provozuje vzdálený server MCP. Přidejte jej jen jednou a vaše AI bude moci spravovat DNS, SSL, servery, porty a přiřazení domén k serverům. Přihlásíte se v prohlížeči; není potřeba vkládat API klíč ani něco instalovat.
$ claude mcp add --transport http nameocean https://nameocean.net/mcp
Claude Desktop a claude.ai: Nastavení → Konektory → Přidat vlastní konektor, URL https://nameocean.net/mcp.
Cursor, VS Code, OpenCode a další: přidejte server HTTP MCP se stejnou adresou URL.
Klienti bez OAuth mohou odesílat Authorization: Bearer <API key>.
API klíče a propojení aplikací vyžadují přihlášení k účtu ve dvou krocích. Zapněte jej
MCP server nemůže registrovat ani prodlužovat domény ani dobíjet kredit a placený server vytvoří až poté, co odsouhlasíte cenu. Aplikace můžete kdykoli odpojit v Ovládací panel → Připojené aplikace.
Rozhraní příkazového řádku nameocean dělá totéž z vašeho terminálu a skriptů a příkaz nameocean mcp install za vás propojí Claude Code, Cursor, OpenCode a VS Code.
$ curl -fsSL https://nameocean.net/install.sh | sh $ nameocean login $ nameocean dns add example.com A @ 203.0.113.10
Místo dotazování API dostanete podepsaný POST, když je doména zaregistrována nebo jí brzy vyprší platnost, když se změní DNS záznam nebo když je vydán certifikát.
Odesílejte transakční e-maily z vlastní domény s událostmi o doručení, vytvářejte schránky, aliasy a e-mailové konference, zapněte bezplatné přesměrování pro domény registrované u nás a přijímejte příchozí poštu na svůj endpoint jako JSON.
Odesílejte klíč v hlavičce Authorization každého požadavku. Odpovědi jsou ve formátu JSON. Limit je 120 požadavků za minutu.
$ 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}
V Nástěnka → API klíče si můžete vytvořit libovolný počet klíčů, každý pouze s oprávněními, která jeho nástroj potřebuje, s volitelným datem vypršení a volitelným seznamem povolených IP adres. Klíč se zobrazí pouze jednou; NameOcean uchovává jen jeho otisk.
Klíč lze také omezit jen na některé vaše domény. Pak funguje pouze na endpointech těchto domén (DNS, SSL, nastavení domény, její e-mail a přesměrování), v GET /dns vidí jen je a všude jinde, včetně serverů, fakturace a vašich ostatních domén, dostane 403 domain_not_allowed. Použijte jej pro CI úlohy a nástroje jako certbot, octoDNS nebo DNSControl.
account:read | E-mail a kredit účtu |
domains:read | Výpis domén, kontrola dostupnosti a ceny |
domains:write | Změna automatického prodlužování, zámku a jmenných serverů; čtení kódu pro převod |
dns:read | Výpis DNS zón a záznamů |
dns:write | Vytváření zón; přidávání, úprava a mazání záznamů |
ssl:read | Stav certifikátů |
ssl:write | Vystavování certifikátů, změna automatického prodlužování |
servers:read | Aplikační servery, jejich porty a domény |
servers:write | Otevírání a zavírání portů, připojování a odpojování domén |
email:read | Poštovní domény, schránky, aliasy, přeposílání a jeho protokol |
email:write | Přidávejte a mažte schránky, aliasy a seznamy; nastavujte hesla; zapínejte a vypínejte přeposílání |
email:send | Odesílání e-mailů z vašich schránek (POST /email/send) |
monitors:read | Monitory dostupnosti, jejich stav a incidenty |
monitors:write | Přidávání, úprava, pozastavení a mazání monitorů dostupnosti |
webhooks:read | Webhookové endpointy a jejich doručení |
webhooks:write | Přidávání, úprava a mazání webhookových endpointů, odesílání testů, opakované odeslání doručení |
billing:write | Registrace a prodlužování domén (čerpá kredit účtu) |
GET vyžaduje <area>:read, ostatní metody <area>:write. Registrace a prodloužení domény navíc vyžadují billing:write; propojení domény se serverem navíc vyžaduje dns:write. Volání bez potřebného oprávnění vrátí 403 s required_scopes. Stejná pravidla platí pro MCP server, pokud je používán s klíčem.
Základní URL: https://nameocean.net/api/v1/
Referenční dokumentace API obsahuje všechna pole, chybové kódy a příklad curl pro každý endpoint; openapi.json lze importovat do Postmanu nebo Insomnie.
| GET | /domains/check?name=example.com | Dostupnost a cena |
| GET | /whois/{name} | Údaje WHOIS/RDAP libovolné domény: registrátor, data, stav, jmenné servery |
| GET | /domains | Vypsat vaše domény |
| POST | /domains | Registrovat doménu s platbou z vašeho zůstatku {"name", "years"} |
| GET | /domains/{name} | Podrobnosti, jmenné servery, stav SSL |
| PATCH | /domains/{name} | Automatické prodloužení a uzamčení proti přenosu {"auto_renew", "locked"} |
| PUT | /domains/{name}/nameservers | {"nameservers": [...]} nebo "nameocean" |
| POST | /domains/{name}/renew | Prodloužit o jeden rok (do 60 dní před vypršením) |
| GET | /domains/{name}/auth-code | Kód přenosu |
| GET | /dns | Vypsat zóny DNS |
| POST | /dns | Vytvořit zónu pro doménu registrovanou jinde {"name"} |
| GET | /dns/{zone}/records | Vypsat záznamy |
| POST | /dns/{zone}/records | Přidat záznam: A, AAAA, CNAME, MX, TXT, SRV, PTR, CAA, REDIRECT |
| PATCH | /dns/{zone}/records/{type}/{id} | Upravit záznam |
| DELETE | /dns/{zone}/records/{type}/{id} | Smazat záznam |
| POST | /dns/{zone}/plan · apply | Změňte celou zónu ze souboru YAML nebo JSON · DNS jako kód → |
| GET | /ssl/{zone} | Stav, datum vypršení a odkaz ke stažení |
| POST | /ssl/{zone} | Vydat bezplatný certifikát typu wildcard |
| PATCH | /ssl/{zone} | Automatické prodloužení {"auto_renew"} |
{server} je ID serveru nebo jeho výchozí domény, například 3f9a1c2e.nameocean.org.
| GET | /servers | Vaše servery s SSH, vzdálenými repozitáři git, porty a doménami |
| GET | /servers/{server} | Jeden server |
| GET | /servers/{server}/ports | Otevřené porty |
| POST | /servers/{server}/ports | Otevřít port TCP nebo UDP {"port", "protocol"} |
| DELETE | /servers/{server}/ports/{id} | Zavřít port |
| GET | /servers/{server}/domains | Přiřazené domény a jejich stav |
| POST | /servers/{server}/domains | Přiřadit doménu nebo subdoménu s HTTPS {"domain"} |
| DELETE | /servers/{server}/domains/{id} | Zrušit přiřazení domény |
| POST | /servers/{server}/deploys | Po git push: restartujte aplikace a zaznamenejte nasazení |
| GET | /servers/{server}/logs | Logy aplikací · všechny endpointy serveru → |
# 1. Zkontrolovat cenu curl "https://nameocean.net/api/v1/domains/check?name=kahvebot.com" -H "Authorization: Bearer $KEY" # 2. Registrovat (účtováno z vašeho zůstatku) 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. Nasměrujte ji na váš 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. Wildcard SSL zdarma curl -X POST https://nameocean.net/api/v1/ssl/kahvebot.com -H "Authorization: Bearer $KEY"
Kompletní referenční dokumentace pro AI agenty, včetně všech polí a typů záznamů, je na nameocean.net/llms.txt. GET /api/v1/ také obsahuje vlastní popis.