Fejlesztők → Gyorsindítás
Öt perc alatt: egy API-kulcs, egy domain elérhetőségének ellenőrzése, egy DNS-rekord és egy webhook, amely értesíti a kódját, ha a rekord megváltozik. Minden lépés működik curllel vagy a nameocean CLI-vel.
Nyissa meg a Vezérlőpult → API-kulcsok oldalt, és hozzon létre egy kulcsot account:read, domains:read, dns:write és webhooks:write jogosultságokkal. A kulcs csak egyszer jelenik meg. A kulcsokhoz kétlépcsős bejelentkezés szükséges a fiókjában.
$ export NAMEOCEAN_API_KEY=no_live_… $ 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}
A CLI-vel kihagyhatja a kulcsot: a nameocean login a böngészőn keresztül jelentkezteti be. Telepítse a brew install nameocean/tap/nameocean vagy a curl -fsSL https://nameocean.net/install.sh | sh paranccsal.
$ nameocean login $ nameocean account
$ curl "https://nameocean.net/api/v1/domains/check?name=kahvebot.com" \ -H "Authorization: Bearer $NAMEOCEAN_API_KEY" {"name": "kahvebot.com", "available": true, "years": 1, "premium": false, "register_price": "10.99", "renew_price": "10.99", "currency": "USD"} $ nameocean domains check kahvebot.com
A regisztráció a POST /domains hívással történik, és a fiók egyenlegéből kerül kifizetésre, ezért a billing:write jogosultság is szükséges hozzá. Az oldal további része egy olyan domaint használ, amely már a NameOcean DNS-en van.
$ curl -X POST https://nameocean.net/api/v1/dns/example.com/records \ -H "Authorization: Bearer $NAMEOCEAN_API_KEY" -H "Content-Type: application/json" \ -d '{"type": "A", "hostname": "app", "ip": "203.0.113.10", "ttl": "5m"}' {"id": 4183, "type": "A", "hostname": "app", "ip": "203.0.113.10", "ttl": "5m"} $ nameocean dns add example.com A app 203.0.113.10 --ttl 5m $ dig +short app.example.com @ns1.nameocean.net 203.0.113.10
A névszerverek másodperceken belül az új rekorddal válaszolnak. A hostname a zónához viszonyított: a @ maga az example.com. Módosítani a PATCH /dns/example.com/records/A/4183 hívással, törölni ugyanezen az útvonalon a DELETE hívással tudja.
Adja meg a NameOceannek, hová küldje a DNS-eseményeket. Az URL-nek nyilvános címen elérhető HTTPS-nek kell lennie; a válasz egyszer tartalmazza az aláíró titkos kulcsot.
$ curl -X POST https://nameocean.net/api/v1/webhooks \ -H "Authorization: Bearer $NAMEOCEAN_API_KEY" -H "Content-Type: application/json" \ -d '{"url": "https://example.com/hooks/nameocean", "events": ["dns.*"]}' {"id": 12, "url": "https://example.com/hooks/nameocean", "events": ["dns.*"], "active": true, "secret": "whsec_…", …} $ curl -X POST https://nameocean.net/api/v1/webhooks/12/test -H "Authorization: Bearer $NAMEOCEAN_API_KEY" {"id": "whd_…", "event": {"type": "webhook.test", …}, "status": "succeeded", "response_status": 200, …}
Most módosítsa a 3. lépés rekordját, és a végpontja kap egy dns.record.updated eseményt a rekord előtte és utána állapotával. Mielőtt megbízna egy hívásban, ellenőrizze az X-NameOcean-Signature fejlécet: ellenőrző kód Pythonhoz, Node-hoz és Go-hoz.
A fentiek mindegyike eszközként is elérhető az MCP szerveren. Claude Code-ban:
$ claude mcp add --transport http nameocean https://nameocean.net/mcp > Point app.example.com to 203.0.113.10 and tell me when the nameservers have it.