Domain Reseller Modül Güncelleme Rehberi
Domain Name API Modülü Nasıl Güncellenir? (Hızlı Özet)
- GitHub deposundan kullandığınız panele ait güncel modülü indirin.
- Mevcut modül dosyalarının yedeğini alın.
- Yeni dosyaları eski dosyaların üzerine yükleyin (overwrite).
- Panel yönetim alanından sürüm numarasını doğrulayın.
- API bağlantı testi yapın (bakiye sorgulama).
- Domain sorgulama, kayıt ve DNS işlemlerini test edin.
Giriş
Domain reseller'ların ve hosting sağlayıcılarının kullandığı otomasyon panelleri ile Domain Name API arasındaki bağlantı, kayıt registrar modülleri üzerinden kurulur. WHMCS domain registrar module, WiseCP domain modülü, HostBill registrar entegrasyonu, Blesta domain registrar module ve ClientExec domain management modülleri zaman içinde güncellenir; çünkü API tarafında yeni özellikler eklenir, güvenlik iyileştirmeleri yapılır ve eski sürümlerle uyumluluk azalır.
Bu rehberde sadece modülün nasıl güncelleneceğini değil; WHMCS registrar error, domain registration failed, WiseCP domain module error gibi sık karşılaşılan sorunları ve domain registrar API integration sürecini de eksiksiz şekilde ele alıyoruz.
Yakın zamanda yeni Domain Name API platformuna geçiş yaptıysanız, modül güncellemesine başlamadan önce aşağıdaki rehberi incelemenizi öneririz:
Geçiş Sonrası Entegrasyon Rehberi
Domain Name API Modülü Nedir?
Registrar modülü, otomasyon panelinizin (WHMCS, WiseCP, HostBill, Blesta, ClientExec) domain registrar API'siyle iletişim kurmasını sağlayan bağlantı katmanıdır. Bu modül sayesinde panel; domain kaydı, transfer, yenileme, DNS yönetimi ve iletişim bilgisi güncelleme gibi işlemleri otomatik olarak Domain Name API üzerinden gerçekleştirir.
Modülün güncel tutulması iki açıdan kritik önem taşır: güvenlik ve performans. Güvenlik açısından, eski modüller bazen güncel olmayan kimlik doğrulama yöntemleri kullanır. Performans açısından ise güncel modüller, API'nin sunduğu daha hızlı ve daha az hata veren uç noktaları kullanır.
Neden Modül Güncellemeli?
Eski bir modülle çalışmak görünürde sorunsuz gibi dursa da arka planda birikimli risk oluşturur. Sık karşılaşılan sorunlar şöyledir:
- Domain kayıt ve transfer işlemlerinin başarısız olması (domain registration failed)
- Yenileme süreçlerinde API hatası alınması
- DNS yönetimi ekranlarının düzgün çalışmaması
- WHOIS bilgilerinin senkronize olmaması
- API kimlik doğrulama hataları (authentication errors)
- Yeni PHP sürümleriyle uyumsuzluk
Örneğin WHMCS kullanan bir reseller, eski modülle yeni bir TLD'de domain kaydı denediğinde 'Registrar Error' hatasıyla karşılaşabilir; bu genellikle modülün yeni TLD parametrelerini desteklememesinden kaynaklanır.
⚠️ Yeni Domain Name API Platformuna Geçtiyseniz
Aşağıdaki durumlardan biri sizi tanımlıyorsa, modül güncellemesinden önce mutlaka geçiş rehberini inceleyin:
- dm.domainnameapi.com üzerinden işlem yapıyorsanız
- Yeni API anahtarları oluşturduysanız
- Yeni entegrasyon modeline geçtiyseniz
Güncelleme Öncesi Hazırlık
Güncellemeye başlamadan önce aşağıdaki adımları tamamlamanız işinizi kolaylaştırır:
- Mevcut modül klasörünün bir yedeğini alın.
- Panelinizin veritabanını yedekleyin.
- API kullanıcı adı ve şifre bilgilerinizi not edin.
- Sunucunuzdaki PHP sürümünü kontrol edin.
- Sunucu firewall ayarlarını ve dosya izinlerini kontrol edin.
- FTP veya dosya yöneticisi erişiminizin çalıştığından emin olun.
Güncel Modülleri İndirme
Tüm güncel modüller GitHub üzerinden ücretsiz olarak yayınlanır (Domain Name API GitHub deposu). Kullandığınız panele göre doğru repoyu seçmeniz gerekir:
➜ Güncel Modülleri İndir (GitHub)
Sayfada WHMCS, WiseCP, HostBill, Blesta, ClientExec ve FOSSBilling için ayrı klasörler bulunur. İlgili klasördeki Download butonuna tıklayarak ZIP dosyasını indirip bilgisayarınızda bir klasöre çıkarmanız yeterli.
WHMCS için Modül Güncelleme
WHMCS domain registrar module update sürecinde aşağıdaki adımları izleyin:
- FileZilla gibi bir FTP programı veya cPanel/Plesk Dosya Yöneticisi ile sunucunuza bağlanın.
- İndirdiğiniz dosyaların içindeki modules klasörünü, WHMCS kurulu olduğu ana dizine (genellikle public_html veya httpdocs) yükleyin.
- Sistem üzerine yazma onayı isterse Tümünü Üzerine Yaz (Overwrite All) seçeneğini onaylayın.
- WHMCS yönetim paneline giriş yapın.
- Sistem Ayarları > Alan Adı Kayıt Firmaları bölümüne gidin.
- Domain Name API modülünün karşısında güncel sürüm numarasının göründüğünü doğrulayın ve ayarları kaydedin.
WHMCS'de Sık Karşılaşılan Sorunlar
Güncelleme sonrası 'WHMCS registrar error' veya 'domain registration failed' hatası alıyorsanız, modülün tam olarak yüklendiğinden ve API bilgilerinin yeniden kaydedildiğinden emin olun. Bazı durumlarda WHMCS önbelleği temizlemek de sorunu çözer.
WiseCP için Modül Güncelleme
WiseCP domain module error sorunlarının önüne geçmek için güncelleme adımları:
- FTP veya Dosya Yöneticisi ile sunucunuza bağlanın.
- İndirdiğiniz WiseCP modül klasörünün içeriğini coremany/modules/Registrars/DomainNameApi dizinine (veya modülün kendi klasör yapısına uygun dizine) yükleyip mevcut dosyaların üzerine yazdırın.
- WiseCP yönetim paneline gidin.
- Ayarlar > Hizmet Ayarları > Alan Adı Kayıt Firmaları adımlarını takip edin.
- Domain Name API modülünü açıp sürümün güncellendiğini teyit edin.
HostBill için Modül Güncelleme
HostBill registrar integration güncellemesi için modül dosyaları genellikle includes/registrars/ dizinine yüklenir; tam yol panel sürümüne göre değişebilir.
- GitHub deposundan HostBill klasörünü indirin.
- Dosyaları includes/registrars/ dizinine (veya GitHub README'de belirtilen dizine) yükleyin.
- HostBill admin panelinden Modüller > Registrar Modülleri bölümüne gidin.
- Domain Name API modülünü etkinleştirip API bilgilerini doğrulayın.
Blesta için Modül Güncelleme
Blesta domain registrar module dosyaları components/modules/ veya plugins/ altındaki ilgili klasöre yüklenir.
- GitHub deposundan Blesta klasörünü indirin.
- Dosyaları components/modules/ dizinine yükleyip üzerine yazın.
- Blesta admin panelinden Ayarlar > Şirket > Modüller bölümüne gidin.
- Domain Name API modülünü yeniden yapılandırıp kaydedin.
ClientExec için Modül Güncelleme
ClientExec domain management modülü genellikle registrars/ dizini altına yüklenir.
- GitHub deposundan ClientExec klasörünü indirin.
- Dosyaları registrars/ dizinine yükleyip mevcut dosyaların üzerine yazın.
- ClientExec admin panelinden Registrar ayarlarına gidin.
- Domain Name API modülünü seçip API bilgilerini kontrol edin.
Tüm paneller için: Klasör yapısı panel sürümüne göre değişebileceğinden, GitHub deposundaki README dosyasını mutlaka kontrol edin.
Sürüm Uyumsuzluğu Belirtileri
Eski bir modül kullandığınızı genellikle panelden alınan hata mesajının türünden anlayabilirsiniz. Panele göre en sık görülen belirtiler şöyledir:
WHMCS
- Registrar Error
- Invalid API Response
- Domain Registration Failed
WiseCP
- Domain Sync Failed
- Authentication Failed
HostBill
- Transfer Failed
- Balance Error
Blesta
- Contact Not Found
ClientExec
- Registrar Communication Error
Bu belirtilerden herhangi birini görüyorsanız, sorun büyük olasılıkla güncel olmayan modül dosyalarından kaynaklanıyordur ve aşağıdaki hata kodları tablosunda çözümünü bulabilirsiniz.
Hata Kodları ve Çözüm Rehberi
Destek ekiplerine ulaşan ticket'ların büyük kısmı aşağıdaki hatalardan kaynaklanır. Bu tabloyu referans alarak çoğu sorunu kendiniz çözebilirsiniz.
| Hata | Olası Sebep | Etkilenen Panel | Çözüm |
|---|---|---|---|
| Authentication Failed | API kullanıcı adı/şifresi modülde tanımlı değil veya yanlış | Tümü | Panel ayarlarından API bilgilerini yeniden girip kaydedin, ardından bağlantı testini çalıştırın |
| Invalid API Response | Eski modül sürümü güncel API uç noktalarıyla uyumsuz | WHMCS, WiseCP, HostBill | Modülü GitHub üzerinden en güncel sürüme yükseltin |
| Registrar Error | Modül, registrar tarafındaki yeni parametre yapısını desteklemiyor | WHMCS, Blesta | Güncel modülü yükleyip ayarları yeniden kaydedin |
| Contact Not Found | İletişim (contact) bilgileri eski formatta tutuluyor | WHMCS, ClientExec | Contact senkronizasyonunu güncel modül üzerinden yeniden çalıştırın |
| Transfer Failed | Transfer için gereken EPP kodu veya parametre modülde eksik | Tümü | Modülü güncelleyip transfer adımlarını güncel arayüzden tekrar deneyin |
| Domain Sync Failed | Panel veritabanı ile API kayıtları eşleşmiyor | WHMCS, WiseCP, HostBill | Senkronizasyon işlemini güncel modül üzerinden yeniden başlatın |
| Balance Error | Bakiye sorgulama fonksiyonu eski API yanıt formatını bekliyor | Tümü | Modülü güncelleyin ve bakiye ekranını yeniden yükleyin |
| Connection Timeout | Sunucu güvenlik duvarı (firewall) API isteklerini engelliyor | Tümü | Firewall üzerinden Domain Name API adreslerine izin verin |
| PHP Fatal Error | Modül, sunucudaki güncel PHP sürümüyle uyumsuz | WHMCS, Blesta, ClientExec | Sunucu PHP sürümünü kontrol edip desteklenen sürüme göre modülü güncelleyin |
| Undefined Method | Modül dosyaları kısmen güncellenmiş, eski ve yeni dosyalar karışmış | Tümü | Eski modül klasörünü tamamen silip güncel paketle yeniden yükleyin |
| Missing Registrar Module | Modül dosyaları doğru dizine yüklenmemiş | Tümü | GitHub'daki klasör yapısını kontrol edip dosyaları doğru dizine taşıyın |
Güncellemenin Başarılı Olduğunu Doğrulama
Modülü güncelledikten sonra aşağıdaki kontrolleri yapmanız, herhangi bir sorunu erkenden fark etmenizi sağlar:
- Bakiye sorgulama ekranının doğru çalıştığını kontrol edin
- Bir domain sorgulaması (availability check) yapın
- Test amaçlı bir domain kaydı deneyin
- Mevcut bir domain üzerinde DNS güncellemesi test edin
- Transfer işlemini test ortamında deneyin
- İletişim bilgisi (contact) güncelleme işlemini test edin
İleri Seviye Sorun Giderme
Standart adımlar sorunu çözmediğinde, aşağıdaki ileri seviye kontrolleri yapabilirsiniz:
- PHP sürümü uyumluluğu: Sunucunuzdaki PHP sürümünün modülün desteklediği aralıkta olduğunu doğrulayın.
- Firewall kısıtlamaları: Sunucunuzun Domain Name API uç noktalarına giden isteklere izin verdiğinden emin olun.
- SSL sertifika doğrulama sorunları: Sunucunuzdaki SSL sertifika zincirinin güncel olduğunu kontrol edin.
- cURL yapılandırma sorunları: PHP cURL eklentisinin etkin ve güncel olduğunu doğrulayın.
- DNS çözümleme sorunları: Sunucunun API alan adını doğru şekilde çözümleyebildiğini test edin.
- Dosya izinleri: Modül dosyalarının panel tarafından okunabilir/yazılabilir izinlere sahip olduğunu kontrol edin.
- API uç nokta değişiklikleri: Çok eski modüllerde API adresi değişmiş olabilir; güncel modül bu sorunu otomatik çözer.
Sıkça Sorulan Sorular
Domain Name API modülünü güncellemek zorunlu mu?
Zorunlu olmasa da şiddetle önerilir. Eski modüller, ileride API tarafında yapılan değişikliklerle uyumsuz hale gelebilir ve domain işlemlerinde hata oluşmasına neden olabilir.
Güncelleme sırasında mevcut ayarlarım kaybolur mu?
Hayır. Modül dosyalarını güncellemek, panelde kayıtlı API kullanıcı adı, şifre ve domain kayıtlarını silmez. Bu bilgiler veritabanında tutulur, dosya güncellemesinden etkilenmez.
Modülü silip yeniden mi kurmalıyım, yoksa üzerine mi yazmalıyım?
Genellikle üzerine yazma (overwrite) yeterlidir. Ancak sürümler arasında büyük yapısal değişiklik varsa, eski klasörü tamamen silip güncel paketi temiz şekilde yüklemek daha güvenlidir.
Güncelleme öncesi yedek almak gerekli mi?
Evet. Hem modül klasörünün hem de panel veritabanının yedeğini almak, olası bir sorunda hızlıca eski sürüme dönebilmenizi sağlar.
Hangi PHP sürümleri destekleniyor?
Desteklenen PHP sürümleri panel ve modül sürümüne göre değişir. Güncel uyumluluk bilgisi için GitHub deposundaki README dosyasını kontrol etmeniz önerilir.
API bağlantısını nasıl test edebilirim?
Panel yönetim alanında modül ayarlarına girip bakiye görüntüleme veya bağlantı testi seçeneğini çalıştırarak API'nin doğru yanıt verdiğini doğrulayabilirsiniz.
Reseller panelimi yakın zamanda yeni Domain Name API platformuna taşıdım, ne yapmalıyım?
Bu durumda modül güncellemesinden önce Geçiş Sonrası Entegrasyon Rehberi'ni incelemeniz, yeni API anahtarlarınızı ve entegrasyon modelinizi doğru şekilde kurmanız açısından önemlidir.
WHMCS için modül nereye yüklenir?
İndirilen paketteki modules klasörü, WHMCS kurulu olduğu ana dizine (genellikle public_html veya httpdocs) yüklenir.
WiseCP için modül nereye yüklenir?
Modül dosyaları coremany/modules/Registrars/DomainNameApi dizinine veya modülün kendi klasör yapısına uygun ilgili dizine yüklenir.
HostBill modül klasör yapısı nasıldır?
HostBill'de modül dosyaları genellikle includes/registrars/ dizinine yüklenir; tam yol panel sürümüne göre değişebilir.
Blesta için modül güncellemesi nasıl yapılır?
Modül dosyaları components/modules/ veya plugins/ altındaki ilgili klasöre yüklenir, ardından panel yönetim alanından modül ayarları kontrol edilir.
ClientExec modül dizini neresidir?
ClientExec'te modül dosyaları genellikle registrars/ dizini altına yüklenir.
Güncelleme sonrası domain sorgulaması neden hata veriyor?
Bu genellikle modülün eksik yüklenmesi veya API bilgilerinin yeniden kaydedilmemiş olmasından kaynaklanır. Dosyaların tam yüklendiğini ve API bilgilerinin doğru girildiğini kontrol edin.
FTP yerine dosya yöneticisi kullanabilir miyim?
Evet. cPanel veya Plesk üzerindeki Dosya Yöneticisi (File Manager) ile de aynı işlemi yapabilirsiniz.
Modül güncellemesi siteyi geçici olarak durdurur mu?
Hayır, dosya yükleme işlemi sırasında sitenizin diğer fonksiyonları normal şekilde çalışmaya devam eder. Sadece domain işlemleri kısa süreliğine etkilenebilir.
Birden fazla panel kullanıyorsam her biri için ayrı mı güncelleme yapmalıyım?
Evet. Her panelin kendi modül yapısı olduğu için, kullandığınız her panel için ilgili GitHub deposundan modülü indirip ayrı ayrı güncellemeniz gerekir.
Modül güncellemesi sonrası eski sürüm numarası görünüyor, ne yapmalıyım?
Tarayıcı önbelleğini temizleyip panel admin alanını yeniden yükleyin. Sorun sürerse dosyaların doğru dizine yüklendiğinden emin olun.
GitHub deposundaki hangi dosyaları sunucuya yüklememeliyim?
.gitignore, README.md ve LICENSE gibi dosyalar sunucu için gerekli değildir; yüklemeseniz de sorun olmaz, yüklediyseniz silebilirsiniz.
Modül güncellemesi sonrası destek ekibine ne zaman başvurmalıyım?
Yukarıdaki hata kodları rehberindeki çözümleri denedikten sonra sorun çözülmüyorsa, Domain Name API destek ekibiyle iletişime geçebilirsiniz.
Yeni bir reseller olarak hangi modülü kullanmalıyım?
Kullandığınız otomasyon paneline göre GitHub deposundaki ilgili klasörü (WHMCS, WiseCP, HostBill, Blesta, ClientExec, FOSSBilling) seçmeniz yeterlidir.
Modül güncellemesi domainlerimi etkiler mi?
Hayır. Modül güncellemesi yalnızca panel ile API arasındaki bağlantı dosyalarını değiştirir; domainleriniz, kayıt bilgileriniz ve müşteri verileriniz bu işlemden etkilenmez.
Güncelleme sonrası transfer işlemleri durur mu?
Hayır, güncelleme sırasında devam eden transfer talepleri API tarafında işlenmeye devam eder. Sadece panel arayüzünden yeni transfer başlatma işlemi modül yüklenene kadar geçici olarak kullanılamayabilir.
Yeni panel için API anahtarlarını yeniden oluşturmam gerekir mi?
Sadece mevcut platformda modül güncelliyorsanız gerekmez. Ancak yeni Domain Name API platformuna geçiş yaptıysanız, yeni API anahtarları oluşturmanız ve bunları panelde güncellemeniz gerekir.
Eski cp.domainnameapi.com hesabımı kullanabilir miyim?
Hesabınızın geçiş durumuna bağlıdır. Yeni platforma taşındıysanız güncel giriş adresini ve API bilgilerini Geçiş Sonrası Entegrasyon Rehberi'nden kontrol etmeniz önerilir.
FOSSBilling modülü nasıl güncellenir?
FOSSBilling için de aynı mantık geçerlidir: GitHub deposundaki FOSSBilling klasörünü indirip ilgili registrar modülleri dizinine yükler, ardından panel admin alanından modülü etkinleştirip API bilgilerini kaydedersiniz.
Domain Name API ile Otomasyonu Bir Adım İleri Taşıyın
Domain Name API, 200'den fazla ülkede hizmet veren, 40.000'den fazla reseller'a altyapı sağlayan ve geniş bir TLD portföyü sunan bir domain registrar altyapısıdır. WHMCS, WiseCP, HostBill, Blesta ve ClientExec gibi panellerle tam entegrasyon desteği sayesinde domain kaydı, transfer ve DNS yönetimi süreçlerini uçtan uca otomatikleştirebilirsiniz.
Modülünüz Güncel mi?
Son sürümü ücretsiz indirin ve panelinizi güvenle güncelleyin:
Alan Adı Satışınızı Otomatikleştirmek İster misiniz?
Domain Name API ile domain kaydı, transfer ve yenileme süreçlerinizi otomatikleştirin, 200+ ülkede geniş TLD portföyüne erişin ve white label reseller programından yararlanın.
40.000+ reseller tarafından kullanılan Domain Name API ile domain satış süreçlerinizi otomatikleştirin.
Ücretsiz Reseller Hesabı Açmak İçin Domain Name API ile İletişime Geçin
Sonuç
Domain Name API modülünü güncel tutmak, panelinizin kesintisiz ve hatasız çalışmasının temel şartıdır. Yukarıdaki adımları takip ederek güncellemeyi güvenli bir şekilde tamamlayabilir, WHMCS registrar error, domain registration failed veya WiseCP domain module error gibi sorunların önüne geçebilirsiniz.
Güncel modüllere her zaman aşağıdaki adresten ulaşabilirsiniz:
Yeni platforma geçiş yaptıysanız önce geçiş rehberini incelemeniz önerilir:
➜ Geçiş Sonrası Entegrasyon Rehberi
Geçiş sürecinde herhangi bir sorunla karşılaşırsanız Domain Name API destek ekibiyle iletişime geçmekten çekinmeyin.
