API Genel Bakış
NiceNIC Alan Adı API v2 Belgeleri ve Hızlı Başlangıç
NiceNIC Alan Adı API v2 hem Perakende Hesapları hem de Bayi Hesapları için kullanılabilir. Erişimi yapılandırmak, ilk isteğinizi doğrulamak, API yanıt modelini anlamak ve doğrudan sol gezintideki doğru bölüme geçmek için bu genel bakışı kullanın.
API erişimi ve bayi fiyatlandırması ayrıdır.
Pazar Hesabı: Pazar Hesabı fiyatlandırmasıyla API erişimi.
Bayi Hesabı: Mevcut bayi kademesine atanan fiyatlandırmayla API erişimi.
Bayi seviyelerini ve fiyatlandırmayı karşılaştırın →
Pazar Hesabı: Pazar Hesabı fiyatlandırmasıyla API erişimi.
Bayi Hesabı: Mevcut bayi kademesine atanan fiyatlandırmayla API erişimi.
Bayi seviyelerini ve fiyatlandırmayı karşılaştırın →
Temel Uç Nokta
https://api.nicenic.net/v2/
Gerekli Üstbilgiler
Host: api.nicenic.net Authorization: username:api_secret Content-Type: application/json
Standart Başarı Yanıtı
{ "code": 0, "msg": "success", "data": {} }
API Test Ortamı
Canlıya Geçmeden Önce Entegrasyonunuzu Test Edin
Üretime geçmeden önce Alan Adı API entegrasyonunuzu test etmek için NiceNIC API Test Ortamını kullanın. Özel bir test ortamında kimlik doğrulamayı, API isteklerini, yanıt yönetimini ve uygulama iş akışınızı doğrulayın.
Bayiler, barındırma sağlayıcıları, geliştiriciler ve API entegrasyonu hazırlayan platformlar için idealdir.
Hızlı Başlangıç
İlk API Çağrınızı 4 Adımda Gerçekleştirin
Canlı kayıtları, yenilemeleri veya transferleri etkinleştirmeden önce salt okunur bir istekle başlayın. Bu, ücretli bir sipariş vermeden kimlik doğrulamayı, istek biçimlendirmesini ve yanıt işlemeyi doğrulamanızı sağlar.
1
API Erişimini Etkinleştir
API Ayarlarını açın, API Anahtarınızı oluşturun veya alın ve geçerli durumlarda yetkili sunucu IP adreslerini yapılandırın.
2
Kimlik Doğrulamasını Onayla
username:api_secret biçimindeki Authorization üstbilgisi ile HTTPS kullanın.
3
Güvenli Bir Test Çalıştırın
Alan adı sorgulama, fiyatlandırma, hesap bakiyesi veya alan adı listeleme ile başlayın.
4
Yanıtı İşleyin
Ücretli üretim eylemlerini etkinleştirmeden önce döndürülen code ve msg değerlerini okuyun ve saklayın.
Önerilen İlk İstek: Alan Adı Müsaitliği
Müsaitlik uç noktası, alan adlarını virgülle ayırarak tek bir istekte birden fazla alan adını destekler.
curl "https://api.nicenic.net/v2/?category=domain&action=check&domains=example.com,example.net" \ -H "Authorization: username:api_secret" \ -H "Content-Type: application/json"
API Haritası
İhtiyacınız Olan İş Akışını Seçin
Aşağıdaki genel bakış sol gezintiyi yansıtır. Doğru iş akışını belirlemek için bunu kullanın, ardından parametreler, istek örnekleri ve yanıt örnekleri için ilgili uç nokta sayfasını açın.
| Bölüm | Kullanım Alanı | Belgelenen İşlevler |
|---|---|---|
| Başlarken | Güvenli bir şekilde bağlanın ve yanıt işlemeyi anlayın. | API Genel Bakışı, API Test Ortamı, Kimlik Doğrulama, Yanıt Kodları. |
| Alan Adı Yönetimi | Temel alan adı yaşam döngüsünü otomatikleştirin. | Müsaitlik, Alan Adlarını Listeleme, Alan Adı Ayrıntıları, Kayıt, Yenileme, İçe Transfer, Ad Sunucuları, Kişiler, Fiyatlandırma. |
| Kötüye Kullanım ve Uyumluluk | Uyumluluk açısından dikkat gerektiren alan adlarını izleyin. | Kötüye kullanım raporları bulunan alan adlarını listeleyin ve makine tarafından okunabilir kötüye kullanım durumunu, bekletme yaşam döngüsünü, şikayet bilgilerini ve önerilen eylemi alın. |
| DNS Kayıtları | Barındırılan DNS kayıtlarını programatik olarak yönetin. | DNS kayıtlarını listeleyin, oluşturun, güncelleyin ve silin. |
| Alt Ad Sunucuları | Kendi alan adınız altındaki ad sunucuları için ana bilgisayar / glue kayıtlarını yönetin. | Alt ad sunucuları (child nameserver) oluşturun, listeleyin, güncelleyin ve silin. |
| Hesap ve Faturalandırma | Otomasyonu hesap düzeyindeki kontrollere bağlayın. | Hesap Bakiyesi ve işlemle ilgili hesap bilgileri. |
| WHMCS API | NiceNIC hizmetini mevcut bir WHMCS faturalandırma iş akışına entegre edin. | Müsaitlik, Kayıt, Yenileme, Transfer, Alan Adı Ayrıntıları, Ad Sunucuları, Kişiler ve ek kayıt kuruluşu modülü işlevleri. |
| API SSS | Yaygın erişim, güvenlik, test ve iş akışı sorularını çözün. | Uygunluk, kimlik bilgileri, istek işleme, desteklenen işlemler ve entegrasyon rehberliği. |
Önerilen İş Akışı
Önerilen İlk Entegrasyon Sırası
Güvenilir bir üretim entegrasyonu, gerçek müşteri siparişlerini göndermeye başlamadan önce erişim ve satın alma koşullarını doğrulamalıdır.
1. Kimlik Doğrulama
API Şifresi + yetkili IP
API Şifresi + yetkili IP
→
2. Kullanılabilirlik
Salt okunur bağlantı testi
Salt okunur bağlantı testi
→
3. Fiyatlandırma
Mevcut hesap düzeyindeki maliyeti sorgulayın
Mevcut hesap düzeyindeki maliyeti sorgulayın
→
4. Bakiye
Ücretli işlemler için bakiyeyi onaylayın
Ücretli işlemler için bakiyeyi onaylayın
→
5. Yanıt İşleme
code + msg işleme
code + msg işleme
→
6. Canlı İşlemler
Kayıt / Yenileme / Transfer
Kayıt / Yenileme / Transfer
Bir API isteğinin yalnızca kabul edildiği için tamamlandığını varsaymayın. Bazı işlemler beklemede (pending) durumu döndürebilir ve nihai alan adı durumu onaylanmadan önce kayıt operatörü (registry) işlemini gerektirebilir.
Canlı Ortam Davranışı
Başarılı, Beklemede ve Hata Yanıtlarını Anlayın
code: 0 — Başarılı Yanıt Mevcut uç nokta örnekleri, başarıyla tamamlanan yanıtlar için 0 kodunu kullanır.
code: 201 — Bekleyen Sipariş Kayıt ve transfer belgeleri, bir sipariş gönderildiğinde ancak nihai işlem henüz beklemedeyken 201 kodunu döndürebilir.
code: 400 — İstek Hatası Uç nokta örnekleri istek parametresi hataları için 400 kodunu kullanır.
Kayıt Bekleme Davranışı
Alan adı kaydı için geçerli belgeler, 201 yanıtının siparişin başarıyla gönderildiği ve ücretin düşüldüğü anlamına geldiğini, ancak nihai aktivasyonun kayıt operatörü onayına tabi olduğunu belirtmektedir. Alan adı aktive edilemezse, kayıt ücreti 24 saat içinde NiceNIC hesap bakiyesine iade edilir.
Transfer Bekleme Davranışı
Transfer uç noktası da 201 kodunu beklemedeki sipariş olarak belgeler. Bu nedenle uygulamanız, beklemedeki bir transferi transferin tamamlandığının kanıtı olarak değil, işleme alınmak üzere kabul edildiği şeklinde ele almalıdır.
Fiyatlandırma
Ücretli İşlemlerden Önce Fiyatları Sorgulayın
NiceNIC fiyatlandırma uç noktası, bir alan adı için kayıt, yenileme ve transfer fiyatlandırmasını alabilir. Belgelenen type değerleri register, renew, transfer ve all şeklindedir. Belgelenen süre, TLD'ye özgü olası istisnalar hariç, 1 ila 10 yıldır.
Kayıt fiyatlandırma yanıtları bir is_premium bayrağı da döndürebilir. Uygulamanızın geçerli hesap düzeyindeki maliyeti bilmesi gerektiğinde ücretli bir istek göndermeden önce fiyatlandırma uç noktasını kullanın.
Ücretsiz API erişimi fiyatlandırma kademenizi değiştirmez. Perakende Hesapları Perakende Hesabı fiyatlandırmasını; bayi hesapları ise mevcut bayi kademelerine atanmış fiyatlandırmayı kullanır.
Alan Adı ve DNS İşlemleri
Ad Sunucuları, DNS Kayıtları ve Alt Ad Sunucuları Arasındaki Farkı Öğrenin
| İşlem | Kullanım Zamanı | Belgelenen Yetenek |
|---|---|---|
| Ad Sunucularını Güncelle | Bir alan adını farklı yetkili ad sunucularına devretmek istiyorsunuz. | Alan adı ad sunucusu uç noktası birincil, ikincil ve ek ad sunucularını destekler; geçerli sayfada en fazla altı adet sınırı belgelenmiştir. |
| DNS Kayıtları | NiceNIC DNS barındırma hizmetini kullanıyorsunuz ve bölge kayıtlarını yönetmeniz gerekiyor. | DNS kayıtlarını listeleme, oluşturma, güncelleme ve silme işlemleri için ayrı API'ler belgelenmiştir. |
| Alt Ad Sunucuları | ns1.example.com gibi host / glue kayıtlarına ihtiyacınız vardır. |
Alt ad sunucuları oluşturun, listeleyin, güncelleyin ve silin. Oluşturma uç noktası, ad sunucusu ana makine adının alan adıyla eşleşmesini gerektirir ve bir IP adresi kabul eder. |
Portföy ve Uyumluluk
Yalnızca Alan Adı Siparişlerini Değil, Portföy İzlemeyi de Otomatikleştirin
Alan Adı API v2, kayıt sonrasında kullanışlı olan okuma işlemlerini de içerir. Alan Adlarını Listele uç noktası sayfalandırma, sıralama, durum filtreleme ve askıya alma (hold) filtrelemesini desteklerken; Alan Adı Ayrıntılarını Al kayıt tarihlerini, sona erme tarihlerini, ad sunucularını ve kayıt sahibi iletişim bilgilerini döndürür.
Kötüye Kullanım ve Uyumluluk İzleme
NiceNIC Kötüye Kullanım ve Uyumluluk API'si, kötüye kullanım raporları bulunan alan adlarını listeleyebilir ve belirli bir alan adı için makine tarafından okunabilir ayrıntılı bir özet döndürebilir. Ayrıntılı kötüye kullanım uç noktası altı alan adı düzeyi durum ifadesini belgeler: Normal, Under Review, Pending ClientHold, ClientHold, Closed ve ServerHold.
Yanıt; geçerli etkiyi, önerilen sonraki eylemi, askıya alma durumunu ve zaman çizelgesini, şikayet sayısını, şikayet tarihlerini, kategorileri, DNS kötüye kullanımı sınıflandırmasını, kanıt durumunu ve varsa bildirilen URL adreslerini içerebilir. Bu sayede platformlar ve bayiler, yalnızca manuel incelemeye bağımlı kalmak yerine uyumluluk durumunu kendi operasyonel sistemlerinde görüntüleyebilir.
Doğrudan API veya WHMCS
Sisteminize Uygun Entegrasyon Modelini Seçin
| Seçenek | En Uygun | Mevcut Belgelerin Sağladıkları |
|---|---|---|
| Alan Adı API v2 | Özel web siteleri, SaaS platformları, dahili sistemler, özel faturalandırma veya temel kaynak sağlama iş akışları. | Alan adı, DNS, alt ad sunucusu, hesap ve uyumluluk işlemlerinde doğrudan HTTPS + JSON entegrasyonu. |
| WHMCS Modülü | Hâlihazırda WHMCS kullanan barındırma şirketleri ve bayiler. | Uygunluk, kayıt, yenileme, transfer, alan adı ayrıntıları, ad sunucuları, kişiler, kilitleme/kilit açma, EPP alma, hata kaydı ve isteğe bağlı Test Modu. |
Mevcut WHMCS dokümantasyonu; WHMCS 7.0 veya üzeri, cURL etkin PHP 7.0 veya üzeri, geçerli NiceNIC API kimlik bilgileri ve SSL/TLS desteğini gereksinimler arasında listeler.
Sorun Giderme
Bir API İsteği Başarısız Olduğunda
Aynı ücretli eylemi tekrar tekrar denemek yerine döndürülen yanıt ve yapılandırma durumuyla başlayın.
Kimlik Doğrulama veya Erişim Hatası
- NiceNIC kullanıcı adını ve API Secret bilgisini doğrulayın.
- Authorization üstbilgisinin mevcut ve doğru biçimlendirilmiş olduğunu doğrulayın.
- API Şifresinin sıfırlanmadığını veya değiştirilmediğini doğrulayın.
- IP kısıtlamaları etkinse, isteğin yetkilendirilmiş giden sunucu IP adresinden geldiğini doğrulayın.
İstek Parametresi Hatası
- İsteği ilgili uç noktanın belgelenmiş parametreleriyle karşılaştırın.
- Gerekli değerleri, biçimleri ve eylem adlarını onaylayın.
- Geçerli olduğu durumlarda TLD'ye özgü kayıt sürelerini veya iletişim bilgilerine ilişkin gereksinimleri kontrol edin.
Ücretli İşlem Hemen Tamamlanmaz
- Dönen
codevemsgdeğerlerini okuyun. 201bekleme yanıtını nihai tamamlanma olarak değerlendirmeyin.- Ücretli bir eylemi yeniden denemeden önce hesap bakiyesini ve geçerli fiyatlandırmayı teyit edin.
NiceNIC Desteğine İhtiyacım Var
- İstek zaman damgasını ve API eylemini kaydedin.
- Varsa ilgili alan adını veya nesneyi ekleyin.
- Döndürülen kodu ve mesajı ekleyin.
- Yalnızca hassas olmayan parametreleri paylaşın; destek talebinde asla API Gizli Anahtarının tamamını paylaşmayın.
Sonraki Adım
Güvenli Bir Test İsteği ile Başlayın
Müşterilere yönelik ücretli işlemleri etkinleştirmeden önce API erişimini açın, kimlik doğrulamasını onaylayın, bir uygunluk veya fiyatlandırma isteği çalıştırın ve yanıt işleme mantığınızı doğrulayın.
Son doğrulama: 26 Ağustos 2026
