API-ul NameOcean permite oricărui program sau asistent AI să facă ce faceți dumneavoastră în panou: să caute și să înregistreze domenii, să schimbe nameserverele, să editeze înregistrări DNS, să emită certificate SSL, să deschidă porturi și să asocieze domenii serverelor dumneavoastră.
Deschideți Panou de control → Chei API, alegeți ce poate face cheia și copiați-o.
Lipiți promptul de mai jos în Claude, ChatGPT sau Cursor, împreună cu cheia dumneavoastră.
"Indică blog.example.com către 203.0.113.10 și activează SSL."
Îmi poți gestiona domeniile cu API-ul NameOcean. Citește https://nameocean.net/llms.txt pentru a afla cum funcționează. Cheia mea API este: [lipiți cheia aici]. Întreabă-mă întotdeauna înainte de orice acțiune care costă bani.
Oferiți fiecărui instrument propria cheie, doar cu permisiunile de care are nevoie. Dacă o cheie este compromisă, ștergeți-o din panoul de control; celelalte vor funcționa în continuare.
NameOcean rulează un server MCP la distanță. Adăugați-l o singură dată și AI-ul dumneavoastră poate gestiona DNS, SSL, servere, porturi și asocieri de domenii. Vă autentificați în browser; nu trebuie să lipiți nicio cheie API și nu instalați nimic.
$ claude mcp add --transport http nameocean https://nameocean.net/mcp
Claude Desktop și claude.ai: Setări → Conectori → Adăugare conector personalizat, URL https://nameocean.net/mcp.
Cursor, VS Code, OpenCode și altele: adăugați un server MCP HTTP cu același URL.
Clienții fără OAuth pot trimite Authorization: Bearer <API key>.
Cheile API și conexiunile aplicațiilor necesită autentificare în doi pași pe contul dumneavoastră. Activați
Serverul MCP nu poate înregistra sau reînnoi domenii și nici nu poate adăuga credit, iar un server cu plată este creat doar după ce sunteți de acord cu prețul. Puteți deconecta aplicațiile oricând din Panou → Aplicații conectate.
CLI-ul nameocean face același lucru din terminal și din scripturile dvs., iar nameocean mcp install conectează automat 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
Primiți un POST semnat atunci când un domeniu este înregistrat sau urmează să expire, o înregistrare DNS se modifică sau un certificat este emis, în loc să interogați periodic API-ul.
Trimiteți e-mailuri tranzacționale de pe propriul domeniu cu evenimente de livrare, creați căsuțe poștale, aliasuri și liste de e-mail, activați redirecționarea gratuită pentru domeniile înregistrate aici și primiți e-mailurile primite la endpointul dvs. în format JSON.
Trimiteți cheia în antetul Authorization al fiecărei solicitări. Răspunsurile sunt în format JSON. Limita este de 120 de solicitări pe 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}
Creați oricâte chei aveți nevoie în Panou → Chei API, fiecare doar cu permisiunile de care are nevoie instrumentul său, cu o dată de expirare opțională și o listă opțională de IP-uri permise. O cheie este afișată o singură dată; NameOcean păstrează doar amprenta acesteia.
O cheie poate fi limitată și la anumite domenii ale dumneavoastră. În acest caz, funcționează doar pe endpointurile acelor domenii (DNS, SSL, setările domeniului, e-mailul și redirecționările sale), vede doar aceste domenii în GET /dns și primește 403 domain_not_allowed în rest, inclusiv pentru servere, facturare și celelalte domenii. Folosiți una pentru joburi CI și instrumente precum certbot, octoDNS sau DNSControl.
account:read | E-mail și credit în cont |
domains:read | Listarea domeniilor, verificarea disponibilității și a prețului |
domains:write | Modificarea reînnoirii automate, a blocării și a serverelor de nume; citirea codului de transfer |
dns:read | Listarea zonelor și înregistrărilor DNS |
dns:write | Crearea zonelor; adăugarea, modificarea și ștergerea înregistrărilor |
ssl:read | Starea certificatelor |
ssl:write | Emiterea certificatelor, modificarea reînnoirii automate |
servers:read | Servere de aplicații, porturile și domeniile lor |
servers:write | Deschiderea și închiderea porturilor, asocierea și disocierea domeniilor |
email:read | Domenii de e-mail, căsuțe poștale, aliasuri, redirecționare și jurnalul acesteia |
email:write | Adăugați și ștergeți căsuțe poștale, aliasuri și liste; setați parole; activați și dezactivați redirecționarea |
email:send | Trimiteți e-mailuri din căsuțele dvs. poștale (POST /email/send) |
monitors:read | Monitoare de uptime, starea lor și incidentele |
monitors:write | Adăugați, modificați, întrerupeți și ștergeți monitoare de uptime |
webhooks:read | Endpoint-uri webhook și livrările lor |
webhooks:write | Adăugați, modificați și ștergeți endpoint-uri webhook, trimiteți teste, retrimiteți livrări |
billing:write | Înregistrarea și reînnoirea domeniilor (consumă din creditul contului) |
GET necesită <area>:read, celelalte metode <area>:write. Înregistrarea și reînnoirea unui domeniu necesită și billing:write; asocierea unui domeniu cu un server necesită și dns:write. Un apel fără scope-ul necesar răspunde cu 403 și required_scopes. Aceleași reguli se aplică serverului MCP atunci când este folosit cu o cheie.
URL de bază: https://nameocean.net/api/v1/
Documentația de referință API conține fiecare câmp, cod de eroare și câte un exemplu curl pentru fiecare endpoint; openapi.json poate fi importat în Postman sau Insomnia.
| GET | /domains/check?name=example.com | Disponibilitate și preț |
| GET | /whois/{name} | Date WHOIS/RDAP pentru orice domeniu: registrar, date, status, nameservere |
| GET | /domains | Listați domeniile dvs. |
| POST | /domains | Înregistrați un domeniu, plătit din soldul dvs. {"name", "years"} |
| GET | /domains/{name} | Detalii, nameservere, stare SSL |
| PATCH | /domains/{name} | Reînnoire automată și blocare transfer {"auto_renew", "locked"} |
| PUT | /domains/{name}/nameservers | {"nameservers": [...]} sau "nameocean" |
| POST | /domains/{name}/renew | Reînnoire pentru un an (în 60 de zile de la expirare) |
| GET | /domains/{name}/auth-code | Cod de transfer |
| GET | /dns | Listați zonele DNS |
| POST | /dns | Creați o zonă pentru un domeniu înregistrat în altă parte {"name"} |
| GET | /dns/{zone}/records | Listați înregistrările |
| POST | /dns/{zone}/records | Adăugați o înregistrare: A, AAAA, CNAME, MX, TXT, SRV, PTR, CAA, REDIRECT |
| PATCH | /dns/{zone}/records/{type}/{id} | Modificați o înregistrare |
| DELETE | /dns/{zone}/records/{type}/{id} | Ștergeți o înregistrare |
| POST | /dns/{zone}/plan · apply | Modificați întreaga zonă dintr-un fișier YAML sau JSON · DNS ca cod → |
| GET | /ssl/{zone} | Stare, dată de expirare și link de descărcare |
| POST | /ssl/{zone} | Emiteți un certificat wildcard gratuit |
| PATCH | /ssl/{zone} | Reînnoire automată {"auto_renew"} |
{server} este ID-ul serverului sau domeniul său implicit, de exemplu 3f9a1c2e.nameocean.org.
| GET | /servers | Serverele dvs. cu SSH, git remote, porturi și domenii |
| GET | /servers/{server} | Un singur server |
| GET | /servers/{server}/ports | Porturi deschise |
| POST | /servers/{server}/ports | Deschideți un port TCP sau UDP {"port", "protocol"} |
| DELETE | /servers/{server}/ports/{id} | Închideți un port |
| GET | /servers/{server}/domains | Domenii asociate și starea lor |
| POST | /servers/{server}/domains | Asociați un domeniu sau subdomeniu cu HTTPS {"domain"} |
| DELETE | /servers/{server}/domains/{id} | Dezasociați un domeniu |
| POST | /servers/{server}/deploys | După git push: reporniți aplicațiile și înregistrați deploy-ul |
| GET | /servers/{server}/logs | Loguri aplicații · toate endpoint-urile pentru servere → |
# 1. Verificați prețul curl "https://nameocean.net/api/v1/domains/check?name=kahvebot.com" -H "Authorization: Bearer $KEY" # 2. Înregistrați (se debitează soldul) 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. Îndreptați-l către serverul dumneavoastră 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"
Referința completă pentru agenți AI, cu fiecare câmp și tip de înregistrare, se găsește la nameocean.net/llms.txt. GET /api/v1/ se descrie, de asemenea, singur.