NiceNIC Alan Adı API v2 Sıkça Sorulan Sorular

NiceNIC Alan Adı API v2, NiceNIC hesabınız üzerinden alan adı yönetimini otomatikleştirmeye yarayan HTTPS ve JSON tabanlı bir API'dir.

Alan adı müsaitlik kontrolleri, kayıt, yenileme, transfer, portföy sorguları, ad sunucusu ve iletişim bilgisi güncellemeleri, fiyatlandırma, DNS kayıtları, alt ad sunucuları, hesap bilgileri ve uyumlulukla ilgili işlemler de dahil olmak üzere temel iş akışlarını destekler.

NiceNIC alan adı hizmetlerini doğrudan bir web sitesine, barındırma platformuna, faturalandırma sistemine, dahili araca veya başka bir uygulamaya bağlamak istediğinizde API'yi kullanın.

Herhangi bir aktif NiceNIC hesabı Alan Adı API v2'yi kullanabilir. API erişimi hem Perakende Hesapları hem de Bayi Hesapları için mevcuttur.

Yalnızca API erişimi elde etmek için bayi olmanız gerekmez. Hesap türü fiyatlandırma açısından önem taşımaya devam eder: ücretli API işlemleri, isteği gönderen NiceNIC hesabına atanan fiyatlandırmayı kullanır.

API Ayarlarını Aç →

Evet. API erişiminin kendisi ücretsizdir. API erişimini etkinleştirmek veya desteklenen API isteklerini göndermek için ayrı bir ücret alınmaz.

Alan adı kaydı, yenileme ve transfer gibi ücretli işlemler, hesap fiyatlandırmanıza ve geçerli alan adı kurallarına göre ücretlendirilir.

Hayır. API erişimi ve bayi fiyatlandırması birbirinden bağımsızdır.

Alan Adı API v2'yi standart bir NiceNIC Perakende Hesabı ile kullanabilirsiniz. Yalnızca bayi fiyatlandırması veya diğer bayilik avantajları iş hacminiz için yararlı olduğunda Bayi Hesabına yükseltin.

Bayi Planlarını Karşılaştırın →

Alan Adı API v2; HTTPS istekleri, JSON yanıtları, üst bilgi tabanlı kimlik doğrulama ve bağımsız alan adı ile hesap iş akışlarına göre düzenlenmiş belgeleriyle mevcut NiceNIC API yapısını kullanır.

Daha eski bir NiceNIC API'si üzerinde oluşturulmuş bir entegrasyonu yönetiyorsanız, iki sürümün birbirinin yerine geçebileceğini varsaymak yerine canlı trafiği taşımadan önce API v2 parametrelerini ve yanıt yönetimini gözden geçirin.

NiceNIC hesabınızda oturum açın ve API Ayarları bölümünü açın. API v2 istekleri, kimlik doğrulama için NiceNIC kullanıcı adınızı ve API Secret bilginizi kullanır.

API Ayarlarını Aç →

Evet. NiceNIC, geliştiricilerin entegrasyonları canlı API'ye bağlamadan önce test etmeleri için bir API Test Ortamı (Sandbox) sağlar.

Canlı müşteri alan adı işlemlerini etkinleştirmeden önce kimlik doğrulamayı, istek biçimlendirmeyi, yanıt ayrıştırmayı, hata yönetimini ve uygulama iş akışınızı doğrulamak için Test Ortamını kullanın.

API Test Ortamı'nı Açın →

API Test Ortamı (Sandbox), geliştirme ve entegrasyon testleri için tasarlanmıştır. Canlı API ise NiceNIC hesabınız üzerinden gerçekleştirilen canlı alan adı işlemleri ve ücretli istekler için kullanılır.

Müşterilere yönelik canlı işlemleri etkinleştirmeden önce kimlik doğrulama, istek yönetimi, yanıt işleme ve hata mantığını Test Ortamında doğrulamanızı öneririz.

API isteklerini HTTPS üzerinden gönderin ve Authorization üstbilgisine NiceNIC kullanıcı adınızı ve API Secret bilginizi ekleyin.

Host: api.nicenic.net
Authorization: username:api_secret
Content-Type: application/json

Hesabınız için IP kısıtlamaları etkinleştirilmişse, isteklerin ayrıca yetkilendirilmiş bir sunucu IP adresinden gelmesi gerekir.

API Kimlik Doğrulama Bilgilerini Oku →

Canlı Ortam API temel uç noktası şudur:

https://api.nicenic.net/v2/

API eylemleri, her uç nokta için belgelenen category ve action gibi parametreler kullanılarak seçilir. Belirli bir işlemin zorunlu ve isteğe bağlı parametreleri için daima ilgili uç noktanın belgelerini takip edin.

API v2 yanıtları JSON biçimini, istek parametreleri ise UTF-8 kodlamasını kullanır.

{
  "code": 0,
  "msg": "success",
  "data": {}
}

Uygulamanız her HTTP yanıtının tamamlanmış bir alan adı işlemini temsil ettiğini varsaymak yerine, dönen code ve msg değerlerini incelemelidir.

Şu anda belgelenen API'ler aracılığıyla alan adı uygunluk kontrolleri, kayıt, yenileme ve transfer, portföy listeleme ve alan adı ayrıntıları, ad sunucusu ve alan adı kişi bilgisi güncellemeleri, alan adı fiyatlandırması, DNS kayıtları, alt ad sunucuları (child nameservers), hesap bilgileri ve Kötüye Kullanım ile Uyumluluk (Abuse & Compliance) takibi dahil iş akışlarını otomatikleştirebilirsiniz.

Ek iş akışları, API gezintisinde ayrı ayrı belgelenmiştir.

Alan adı uygunluğu, alan adı fiyatlandırması, hesap bakiyesi ve alan adı listeleme gibi düşük riskli okuma işlemleriyle başlayın.

Ardından canlı kayıtları, yenilemeleri veya transferleri etkinleştirmeden önce kimlik doğrulamayı, yanıt ayrıştırmayı, hata yönetimini ve bekleyen sipariş süreçlerini onaylayın.

Evet. Check Domain Availability (Alan Adı Müsaitliğini Kontrol Et) uç noktası, virgülle ayrılmış birden fazla alan adını destekler.

example.com,example.net,example.org

Her API işleminin aynı çoklu alan adı giriş biçimini desteklediğini varsaymayın. Kayıt, yenileme ve transfer işlemleri kendi uç nokta dokümantasyonuna uygun olmalıdır.

Get Domain Pricing (Alan Adı Fiyatlandırmasını Al) uç noktasını kullanın. Dokümantasyonda belirtilen fiyatlandırma türleri register, renew, transfer ve all seçeneklerini içerir.

Kayıt yanıtları ayrıca sorgulanan kaydın premium olup olmadığını belirten bir is_premium değeri de içerebilir.

API siparişleri hesap düzeyindeki fiyatlandırmayı kullandığından, süresiz olarak önbelleğe alınmış fiyatlara güvenmek yerine ücretli müşteri siparişlerini göndermeden önce güncel fiyatları sorgulayın.

Hayır. API dokümantasyonu geçerli uzantılar için 1–10 yıla kadar olan süreleri desteklese de, bağımsız TLD'lerin farklı kayıt kuruluşu kuralları olabilir.

Kayıt süreleri, yenileme süreleri, transfer uygunluğu, kişi bilgisi gereksinimleri ve doğrulama gereksinimleri uzantıya göre değişiklik gösterebilir. Uygulamanız ilgili TLD için geçerli kurallara uymalıdır.

Bunlar ayrı işlemlerdir ve birbirinin yerine geçebilir kabul edilmemelidir.

Bir API isteğinin durumunu belirlerken her zaman dönen kodu ve mesajı dikkate alın.

API Yanıt Kodlarını Görüntüle →

Bir 201 yanıtı, işlemin işlenmek üzere kabul edildiği ancak nihai durumuna henüz ulaşmamış olabileceği anlamına gelir.

Alan adı kaydı için 201 yanıtı, siparişin iletildiğini ve nihai kayıt kuruluşu işlemini beklediğini belirtir.

Sisteminiz nihai sonucu onaylayana kadar son müşteriye alan adının aktif olduğunu bildirmeyin. Güncel bekleyen sipariş ve iade yönetimi kuralları için kayıt uç noktası belgelerini takip edin.

Bekleyen transfer yanıtı, transfer isteğinin işleme alındığı anlamına gelir; alan adının NiceNIC tarafına transferinin tamamlandığı anlamına gelmez.

Transferin tamamlanması, alan adının mevcut transfer durumunun yanı sıra kayıt kuruluşu (registry) ve kayıt operatörünün (registrar) işlem süreçlerine bağlı olabilir. Tamamlanma onaylanana kadar transferi beklemede durumunda tutun.

Evet. List Domains API'si sayfalama, sıralama ve filtreleme seçenekleriyle portföy almayı destekler.

Kayıt bilgileri, bitiş tarihi bilgileri, ad sunucuları ve alan adı kişi verileri gibi tek bir alan adına ait ayrıntılı bilgilere ihtiyaç duyduğunuzda Get Domain Details (Alan Adı Ayrıntılarını Al) seçeneğini kullanın.

NiceNIC Alan Adı API v2, müşteri alan adı portföylerini yöneten platformlar ve bayiler için tasarlanmış Kötüye Kullanım ve Uyumluluk (Abuse & Compliance) işlemlerini içerir.

Kötüye kullanım bildirimleriyle ilişkili alan adlarını tespit edebilir ve bağımsız alan adları için makine tarafından okunabilir uyumluluk bilgilerini alabilirsiniz. Duruma bağlı olarak yanıt; alan adı durumunu, mevcut etkiyi, önerilen işlemi, askıya alma bilgilerini, şikayet ayrıntılarını ve bildirilen URL adreslerini içerebilir.

Bu sayede uyumluluk durumunu doğrudan kendi müşteri portalınız veya operasyonel sisteminiz içinde görüntülemeniz mümkün hale gelir.

Evet. NiceNIC, faturalandırma ve provizyon işlemleri için halihazırda WHMCS kullanan işletmelere yönelik bir WHMCS kayıt kuruluşu entegrasyonu sunar.

Kendi uygulamanızı veya iş akışınızı oluştururken doğrudan Alan Adı API v2'yi kullanın. Alan adı işlemlerinin mevcut bir WHMCS ortamına entegre edilmesini istediğinizde ise WHMCS entegrasyonunu kullanın.

WHMCS Entegrasyonunu Görüntüle →

HTTPS istekleri gönderebilen ve JSON ayrıştırabilen herhangi bir sunucu tarafı programlama dili veya çalışma ortamı Alan Adı API v2 ile entegre olabilir.

Yaygın tercihler arasında PHP, Python, Node.js ve Java yer alır. API kimlik bilgilerini sunucu tarafında tutun ve API Secret bilginizi asla tarayıcı tarafı JavaScript'te veya indirilebilir istemci kodunda açıkta bırakmayın.

API kararlılığını ve platform güvenliğini korumak amacıyla istek sınırlaması (rate limiting) uygulanabilir.

Canlı entegrasyonunuzun sürekli yüksek istek hacmi oluşturması bekleniyorsa, beklenen kullanım düzeninizin incelenebilmesi için yayına almadan önce NiceNIC ile iletişime geçin.

İstek zaman damgasını, API kategorisini ve eylemini, varsa alan adını, hassas olmayan istek parametrelerini, dönen yanıt kodunu ve iletisini, ayrıca isteğin Test Ortamından mı yoksa Canlı Ortamdan mı geldiğini dahil edin.

Destek Talebi Gönderin →

Dokümantasyondaki API gezintisini kullanın. Her işlemin desteklenen parametreler, istek örnekleri, yanıt örnekleri ve işleme özel davranışlar için kendi sayfası bulunur.

SSS bölümü genel API davranışını açıklar; tam istek biçimi için tekil uç nokta dokümantasyonu esas alınmalıdır.

API Dokümantasyonunu Aç →