NameOcean API, herhangi bir programın veya yapay zekâ asistanının panelde yaptığınız her şeyi yapmasını sağlar: alan adı arama ve kaydetme, nameserver değiştirme, DNS kayıtlarını düzenleme, SSL sertifikası verme, port açma ve alan adlarını sunucularınıza bağlama.
Panel → API anahtarları sayfasını açın, anahtarın neler yapabileceğini seçin ve anahtarı kopyalayın.
Aşağıdaki istemi anahtarınızla birlikte Claude, ChatGPT veya Cursor'a yapıştırın.
"blog.example.com adresini 203.0.113.10 IP'sine yönlendir ve SSL'i aç."
Alan adlarımı NameOcean API ile yönetebilirsin. Nasıl çalıştığını öğrenmek için https://nameocean.net/llms.txt adresini oku. API anahtarım: [anahtarınızı buraya yapıştırın]. Para gerektiren herhangi bir işlemden önce mutlaka bana sor.
Her araca yalnızca ihtiyaç duyduğu izinlere sahip ayrı bir anahtar verin. Bir anahtar sızarsa panelden silin; diğerleri çalışmaya devam eder.
NameOcean bir uzak MCP sunucusu çalıştırır. Bir kez ekleyin; yapay zekânız DNS, SSL, sunucular, portlar ve alan adı bağlantılarını yönetebilsin. Tarayıcıdan giriş yaparsınız; yapıştırılacak API anahtarı ve kurulacak bir şey yoktur.
$ claude mcp add --transport http nameocean https://nameocean.net/mcp
Claude Desktop ve claude.ai: Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle, URL https://nameocean.net/mcp.
Cursor, VS Code, OpenCode ve diğerleri: aynı URL ile bir HTTP MCP sunucusu ekleyin.
OAuth desteklemeyen istemciler şunu gönderebilir: Authorization: Bearer <API key>.
API anahtarları ve uygulama bağlantıları için hesabınızda iki adımlı giriş gerekir. Etkinleştir
MCP sunucusu alan adı kaydedemez, yenileyemez veya bakiye ekleyemez; ücretli bir sunucuyu ise yalnızca fiyatı onaylamanızdan sonra oluşturur. Uygulamaların bağlantısını istediğiniz zaman şuradan kesebilirsiniz: Kontrol Paneli → Bağlı uygulamalar.
nameocean CLI aynı işlemleri terminalinizden ve betiklerinizden yapar; nameocean mcp install ise Claude Code, Cursor, OpenCode ve VS Code bağlantısını sizin için kurar.
$ curl -fsSL https://nameocean.net/install.sh | sh $ nameocean login $ nameocean dns add example.com A @ 203.0.113.10
API'yi sürekli sorgulamak yerine, bir alan adı kaydedildiğinde veya süresi dolmak üzereyken, bir DNS kaydı değiştiğinde ya da bir sertifika düzenlendiğinde imzalı bir POST isteği alın.
Kendi alan adınızdan teslimat olaylarıyla işlemsel e-posta gönderin, posta kutuları, takma adlar ve e-posta listeleri oluşturun, burada kayıtlı alan adları için ücretsiz yönlendirmeyi açın ve gelen postaları uç noktanızda JSON olarak alın.
Anahtarınızı her isteğin Authorization başlığında gönderin. Yanıtlar JSON biçimindedir. Sınır dakikada 120 istektir.
$ 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}
Panel → API anahtarları bölümünde ihtiyacınız kadar anahtar oluşturabilirsiniz; her birine yalnızca ilgili aracın ihtiyaç duyduğu izinleri, isteğe bağlı bir son kullanma tarihi ve isteğe bağlı bir izin verilen IP listesi tanımlayabilirsiniz. Anahtar yalnızca bir kez gösterilir; NameOcean yalnızca parmak izini saklar.
Bir anahtar, alan adlarınızın yalnızca bir kısmıyla da sınırlandırılabilir. Bu durumda anahtar yalnızca bu alan adlarının uç noktalarında (DNS, SSL, alan adının ayarları, e-postası ve yönlendirmesi) çalışır, GET /dns içinde yalnızca bu alan adlarını görür ve sunucular, faturalandırma ve diğer alan adlarınız dahil diğer her yerde 403 domain_not_allowed yanıtı alır. CI işleri ve certbot, octoDNS ya da DNSControl gibi araçlar için bu tür bir anahtar kullanın.
account:read | E-posta ve hesap bakiyesi |
domains:read | Alan adlarını listeleme, uygunluk ve fiyat sorgulama |
domains:write | Otomatik yenileme, kilit ve ad sunucularını değiştirme; transfer kodunu okuma |
dns:read | DNS bölgelerini ve kayıtlarını listeleme |
dns:write | Bölge oluşturma; kayıt ekleme, değiştirme ve silme |
ssl:read | Sertifika durumu |
ssl:write | Sertifika oluşturma, otomatik yenilemeyi değiştirme |
servers:read | Uygulama sunucuları, portları ve alan adları |
servers:write | Port açma ve kapatma, alan adı bağlama ve bağlantıyı kaldırma |
email:read | Posta alan adları, posta kutuları, takma adlar, yönlendirme ve günlüğü |
email:write | Posta kutuları, takma adlar ve listeler ekleyin ve silin; parola belirleyin; yönlendirmeyi açın ve kapatın |
email:send | Posta kutularınızdan e-posta gönderin (POST /email/send) |
monitors:read | Çalışma süresi monitörleri, durumları ve olaylar |
monitors:write | Çalışma süresi monitörlerini ekleyin, değiştirin, duraklatın ve silin |
webhooks:read | Webhook uç noktaları ve gönderimleri |
webhooks:write | Webhook uç noktalarını ekleyin, değiştirin ve silin, test gönderin, gönderimleri yeniden gönderin |
billing:write | Alan adı kaydetme ve yenileme (hesap bakiyesi harcar) |
GET istekleri <area>:read, diğer yöntemler ise <area>:write gerektirir. Alan adı kaydetmek ve yenilemek ayrıca billing:write, bir alan adını sunucuya bağlamak ise ayrıca dns:write gerektirir. Gerekli kapsama sahip olmayan bir çağrı, required_scopes ile birlikte 403 yanıtı döndürür. Aynı kurallar, MCP sunucusu bir anahtarla kullanıldığında da geçerlidir.
Temel URL: https://nameocean.net/api/v1/
API referansı, her uç nokta için tüm alanları, hata kodlarını ve bir curl örneğini içerir; openapi.json dosyası Postman veya Insomnia'ya aktarılabilir.
| GET | /domains/check?name=example.com | Uygunluk ve fiyat |
| GET | /whois/{name} | Herhangi bir alan adının WHOIS/RDAP verileri: kayıt firması, tarihler, durum, ad sunucuları |
| GET | /domains | Alan adlarınızı listeleyin |
| POST | /domains | Alan adı kaydedin, bakiyenizden ödenir {"name", "years"} |
| GET | /domains/{name} | Ayrıntılar, nameserver'lar, SSL durumu |
| PATCH | /domains/{name} | Otomatik yenileme ve transfer kilidi {"auto_renew", "locked"} |
| PUT | /domains/{name}/nameservers | {"nameservers": [...]} veya "nameocean" |
| POST | /domains/{name}/renew | Bir yıl yenile (bitiş tarihinden önceki 60 gün içinde) |
| GET | /domains/{name}/auth-code | Transfer kodu |
| GET | /dns | DNS bölgelerini listeleyin |
| POST | /dns | Başka yerde kayıtlı bir alan adı için bölge oluşturun {"name"} |
| GET | /dns/{zone}/records | Kayıtları listeleyin |
| POST | /dns/{zone}/records | Kayıt ekleyin: A, AAAA, CNAME, MX, TXT, SRV, PTR, CAA, REDIRECT |
| PATCH | /dns/{zone}/records/{type}/{id} | Kaydı değiştirin |
| DELETE | /dns/{zone}/records/{type}/{id} | Kaydı silin |
| POST | /dns/{zone}/plan · apply | Tüm bölgeyi bir YAML veya JSON dosyasından değiştirin · Kod olarak DNS → |
| GET | /ssl/{zone} | Durum, bitiş tarihi ve indirme bağlantısı |
| POST | /ssl/{zone} | Ücretsiz wildcard sertifika verin |
| PATCH | /ssl/{zone} | Otomatik yenileme {"auto_renew"} |
{server}, sunucu kimliği veya varsayılan alan adıdır; örneğin 3f9a1c2e.nameocean.org.
| GET | /servers | SSH, git remote, portlar ve alan adlarıyla sunucularınız |
| GET | /servers/{server} | Tek sunucu |
| GET | /servers/{server}/ports | Açık portlar |
| POST | /servers/{server}/ports | TCP veya UDP portu açın {"port", "protocol"} |
| DELETE | /servers/{server}/ports/{id} | Bir portu kapatın |
| GET | /servers/{server}/domains | Bağlı alan adları ve durumları |
| POST | /servers/{server}/domains | HTTPS ile bir alan adı veya alt alan adı bağlayın {"domain"} |
| DELETE | /servers/{server}/domains/{id} | Bir alan adının bağlantısını kaldırın |
| POST | /servers/{server}/deploys | git push sonrası: uygulamaları yeniden başlatın ve dağıtımı kaydedin |
| GET | /servers/{server}/logs | Uygulama günlükleri · tüm sunucu uç noktaları → |
# 1. Fiyatı kontrol edin curl "https://nameocean.net/api/v1/domains/check?name=kahvebot.com" -H "Authorization: Bearer $KEY" # 2. Kayıt yaptırın (bakiyenizden ücret alınır) 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. Sunucunuza yönlendirin 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. Ücretsiz wildcard SSL curl -X POST https://nameocean.net/api/v1/ssl/kahvebot.com -H "Authorization: Bearer $KEY"
Tüm alanları ve kayıt türlerini içeren, yapay zeka ajanlarına yönelik tam başvuru belgesi nameocean.net/llms.txt adresindedir. GET /api/v1/ de kendisini tanımlar.