7/24 Destek
SSS
 Kontrol Paneli
Hesap Bakiyesi:    

Geliştiriciler → Hızlı Başlangıç

Hızlı Başlangıç

Beş dakikada: bir API anahtarı, alan adı uygunluk sorgusu, bir DNS kaydı ve kayıt değiştiğinde kodunuzu bilgilendiren bir webhook. Her adım curl veya nameocean CLI ile çalışır.

1. Anahtar alın

Kontrol Paneli → API anahtarları sayfasını açın ve account:read, domains:read, dns:write ve webhooks:write yetkilerine sahip bir anahtar oluşturun. Anahtar yalnızca bir kez gösterilir. Anahtar oluşturabilmek için hesabınızda iki adımlı giriş etkin olmalıdır.

curl
$ 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}

CLI ile anahtara gerek yoktur: nameocean login tarayıcı üzerinden oturum açar. Kurmak için brew install nameocean/tap/nameocean veya curl -fsSL https://nameocean.net/install.sh | sh komutunu kullanın.

nameocean
$ nameocean login
$ nameocean account

2. Alan adı sorgulayın

curl
$ 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

Kayıt işlemi POST /domains ile yapılır ve hesap bakiyesinden ödenir; bu nedenle billing:write yetkisi de gerekir. Bu sayfanın geri kalanında NameOcean DNS'te zaten bulunan bir alan adı kullanılmaktadır.

3. DNS kaydı ekleyin

curl
$ 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

Ad sunucuları yeni kayıtla saniyeler içinde yanıt verir. hostname bölgeye görelidir: @, example.com'un kendisidir. Kaydı PATCH /dns/example.com/records/A/4183 ile değiştirin, aynı yola DELETE göndererek silin.

4. Webhook alın

NameOcean'a DNS olaylarını nereye göndereceğini bildirin. URL, herkese açık bir adreste HTTPS olmalıdır; yanıt, imzalama anahtarını yalnızca bir kez içerir.

curl
$ 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, …}

Şimdi 3. adımdaki kaydı değiştirin; uç noktanız, kaydın önceki ve sonraki hâlini içeren bir dns.record.updated olayı alır. Bir çağrıya güvenmeden önce X-NameOcean-Signature başlığını doğrulayın: Python, Node ve Go için doğrulama kodu.

5. Ya da yapay zekânıza yaptırın

Yukarıdakilerin tümü MCP sunucusunda bir araç olarak da mevcuttur. Claude Code'da:

Claude Code
$ 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.

İleri