NameOcean API pozwala dowolnemu programowi lub asystentowi AI robić to, co Ty w panelu: wyszukiwać i rejestrować domeny, zmieniać serwery nazw, edytować rekordy DNS, wystawiać certyfikaty SSL, otwierać porty i powiązywać domeny z Twoimi serwerami.
Otwórz Panel → Klucze API, wybierz, co klucz może robić, i skopiuj go.
Wklej poniższy prompt do Claude, ChatGPT lub Cursor razem ze swoim kluczem.
"Skieruj blog.example.com na 203.0.113.10 i włącz SSL."
Możesz zarządzać moimi domenami za pomocą API NameOcean. Przeczytaj https://nameocean.net/llms.txt, aby dowiedzieć się, jak to działa. Mój klucz API: [wklej tutaj swój klucz]. Zawsze pytaj mnie o zgodę przed każdą czynnością, która wiąże się z kosztami.
Każdemu narzędziu przydziel osobny klucz z tylko niezbędnymi uprawnieniami. Jeśli klucz wycieknie, usuń go w panelu – pozostałe będą działać dalej.
NameOcean udostępnia zdalny serwer MCP. Dodaj go raz, a Twoje AI będzie mogło zarządzać DNS, SSL, serwerami, portami i powiązaniami domen. Logujesz się w przeglądarce; nie musisz wklejać klucza API ani niczego instalować.
$ claude mcp add --transport http nameocean https://nameocean.net/mcp
Claude Desktop i claude.ai: Ustawienia → Konektory → Dodaj własny konektor, adres URL https://nameocean.net/mcp.
Cursor, VS Code, OpenCode i inne: dodaj serwer HTTP MCP z tym samym adresem URL.
Klienci bez OAuth mogą wysłać Authorization: Bearer <API key>.
Klucze API i połączenia aplikacji wymagają logowania dwuetapowego na Twoim koncie. Włącz
Serwer MCP nie może rejestrować ani odnawiać domen ani doładowywać środków, a płatny serwer tworzy dopiero po zaakceptowaniu przez Państwa ceny. Aplikacje można odłączyć w dowolnym momencie w Panel → Połączone aplikacje.
CLI nameocean robi to samo z poziomu terminala i skryptów, a polecenie nameocean mcp install samo podłącza Claude Code, Cursor, OpenCode i VS Code.
$ curl -fsSL https://nameocean.net/install.sh | sh $ nameocean login $ nameocean dns add example.com A @ 203.0.113.10
Otrzymuj podpisane żądanie POST, gdy domena zostanie zarejestrowana lub wkrótce wygaśnie, zmieni się rekord DNS albo zostanie wystawiony certyfikat – zamiast odpytywać API.
Wysyłaj e-maile transakcyjne z własnej domeny ze zdarzeniami doręczenia, twórz skrzynki, aliasy i listy mailingowe, włączaj darmowe przekierowanie dla domen zarejestrowanych u nas i odbieraj przychodzącą pocztę w swoim endpoincie jako JSON.
Przesyłaj swój klucz w nagłówku Authorization w każdym żądaniu. Odpowiedzi są w formacie JSON. Limit wynosi 120 żądań na minutę.
$ 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}
Możesz utworzyć dowolną liczbę kluczy w Panel → Klucze API, każdy tylko z uprawnieniami potrzebnymi danemu narzędziu, z opcjonalną datą wygaśnięcia i opcjonalną listą dozwolonych adresów IP. Klucz jest wyświetlany tylko raz; NameOcean przechowuje wyłącznie jego odcisk.
account:read | E-mail i środki na koncie |
domains:read | Wyświetlanie domen, sprawdzanie dostępności i cen |
domains:write | Zmiana automatycznego odnawiania, blokady i serwerów nazw; odczyt kodu transferu |
dns:read | Wyświetlanie stref i rekordów DNS |
dns:write | Tworzenie stref; dodawanie, zmiana i usuwanie rekordów |
ssl:read | Status certyfikatów |
ssl:write | Wystawianie certyfikatów, zmiana automatycznego odnawiania |
servers:read | Serwery aplikacji, ich porty i domeny |
servers:write | Otwieranie i zamykanie portów, przypisywanie i odpinanie domen |
email:read | Domeny pocztowe, skrzynki, aliasy, przekierowania i ich dziennik |
email:write | Dodawanie i usuwanie skrzynek, aliasów i list; ustawianie haseł; włączanie i wyłączanie przekierowań |
email:send | Wysyłanie e-maili z Twoich skrzynek (POST /email/send) |
monitors:read | Monitory dostępności, ich status i incydenty |
monitors:write | Dodawanie, zmiana, wstrzymywanie i usuwanie monitorów dostępności |
webhooks:read | Endpointy webhooków i ich dostarczenia |
webhooks:write | Dodawanie, zmiana i usuwanie endpointów webhooków, wysyłanie testów, ponowne wysyłanie dostarczeń |
billing:write | Rejestracja i odnawianie domen (wykorzystuje środki na koncie) |
GET wymaga <area>:read, pozostałe metody <area>:write. Rejestracja i odnowienie domeny wymagają też billing:write; powiązanie domeny z serwerem wymaga też dns:write. Wywołanie bez wymaganego zakresu zwraca 403 z required_scopes. Te same zasady dotyczą serwera MCP używanego z kluczem.
Bazowy adres URL: https://nameocean.net/api/v1/
Dokumentacja API zawiera wszystkie pola, kody błędów i przykład curl dla każdego endpointu; plik openapi.json można zaimportować do Postmana lub Insomnii.
| GET | /domains/check?name=example.com | Dostępność i cena |
| GET | /whois/{name} | Dane WHOIS/RDAP dowolnej domeny: rejestrator, daty, status, serwery nazw |
| GET | /domains | Lista Twoich domen |
| POST | /domains | Rejestracja domeny, płatność z salda {"name", "years"} |
| GET | /domains/{name} | Szczegóły, serwery nazw, status SSL |
| PATCH | /domains/{name} | Automatyczne odnawianie i blokada transferu {"auto_renew", "locked"} |
| PUT | /domains/{name}/nameservers | {"nameservers": [...]} lub "nameocean" |
| POST | /domains/{name}/renew | Odnowienie na rok (w ciągu 60 dni przed wygaśnięciem) |
| GET | /domains/{name}/auth-code | Kod transferu |
| GET | /dns | Lista stref DNS |
| POST | /dns | Utwórz strefę dla domeny zarejestrowanej gdzie indziej {"name"} |
| GET | /dns/{zone}/records | Lista rekordów |
| POST | /dns/{zone}/records | Dodaj rekord: A, AAAA, CNAME, MX, TXT, SRV, PTR, CAA, REDIRECT |
| PATCH | /dns/{zone}/records/{type}/{id} | Zmień rekord |
| DELETE | /dns/{zone}/records/{type}/{id} | Usuń rekord |
| POST | /dns/{zone}/plan · apply | Zmień całą strefę na podstawie pliku YAML lub JSON · DNS jako kod → |
| GET | /ssl/{zone} | Status, data wygaśnięcia i link do pobrania |
| POST | /ssl/{zone} | Wystaw bezpłatny certyfikat wildcard |
| PATCH | /ssl/{zone} | Automatyczne odnawianie {"auto_renew"} |
{server} to identyfikator serwera lub jego domyślna domena, na przykład 3f9a1c2e.nameocean.org.
| GET | /servers | Twoje serwery z SSH, git remote, portami i domenami |
| GET | /servers/{server} | Jeden serwer |
| GET | /servers/{server}/ports | Otwarte porty |
| POST | /servers/{server}/ports | Otwórz port TCP lub UDP {"port", "protocol"} |
| DELETE | /servers/{server}/ports/{id} | Zamknij port |
| GET | /servers/{server}/domains | Powiązane domeny i ich status |
| POST | /servers/{server}/domains | Powiąż domenę lub subdomenę z HTTPS {"domain"} |
| DELETE | /servers/{server}/domains/{id} | Odepnij domenę |
| POST | /servers/{server}/deploys | Po git push: zrestartuj aplikacje i zapisz wdrożenie |
| GET | /servers/{server}/logs | Logi aplikacji · wszystkie endpointy serwerów → |
# 1. Sprawdź cenę curl "https://nameocean.net/api/v1/domains/check?name=kahvebot.com" -H "Authorization: Bearer $KEY" # 2. Zarejestruj (obciąża Twoje saldo) 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. Skieruj ją na swój serwer 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. Darmowy wildcard SSL curl -X POST https://nameocean.net/api/v1/ssl/kahvebot.com -H "Authorization: Bearer $KEY"
Pełna dokumentacja dla agentów AI, z każdym polem i typem rekordu, znajduje się pod adresem nameocean.net/llms.txt. GET /api/v1/ również opisuje się samo.