Domain Name API v2 Geçiş Sonrası Entegrasyon Rehberi: Reseller Not Found, Invalid API Key ve Bağlantı Sorunlarının Tüm Çözümleri

Dün çalışan API entegrasyonunuz bugün neden bağlanmıyor? WHMCS modülümü güncelledim ama hata devam ediyor. Reseller ID ve API Key'i doğru girdim, yine de “Reseller not found” alıyorum. WiseCP senkronizasyonu başarılı gösteriyor ama bakiye ve fiyatlar gelmiyor.

Bu sorularla karşılaşıyorsanız yalnız değilsiniz. Domain Name API REST API altyapısı, kimlik doğrulama (API Authentication) ve güvenlik katmanları güncellendi. Domain Name API, Temmuz 2026 itibarıyla tüm API altyapısını yeni nesil v2 (mikroservis) mimarisine taşıdı. Bu geçiş, güvenlik ve performans açısından önemli iyileştirmeler getirdi; ancak kimlik doğrulama yapısı, entegrasyon parametreleri ve modül gereksinimleri kökten değişti.

Endişelenmeyin. Bu hataların büyük bölümü yalnızca birkaç dakikada çözülebilir. Bu rehber, geçiş sonrasında WHMCS, WiseCP, HostBill, Blesta, ClientExec ve özel yazılım kullanan bayilerin karşılaştığı tüm hataları, nedenlerini ve adım adım çözümlerini tek bir yerde topluyor. Domain Reseller API, domain registration API veya billing panel entegrasyonuyla ilgili her sorununuzu burada bulabilirsiniz.

Bu Rehber Ne Zaman Gerekli?

v2 Geçişi Neden Bu Kadar Önemli Değişikliklere Neden Oldu?

Domain Name API, büyüyen reseller ekosistemi için güvenlik ve ölçeklenebilirliği artırmak amacıyla tüm altyapısını yeni nesil mikroservis mimarisine taşıdı. Bu geçiş, eski SOAP tabanlı v1 sisteminin yerini alıyor ve şu temel değişiklikleri içeriyor:

Değişen Özellik	Eski v1 Yapısı	Yeni v2 Yapısı
Kimlik Doğrulama	UserName + Panel Şifresi	Reseller ID + API Key
API Adresi	eski.domainnameapi.com veya v1 URL'leri	api.domainresellerapi.com (v2)
Güvenlik	IP doğrulaması isteğe bağlı	IP White List zorunlu
Protokol	SOAP/XML	REST/JSON
Modül uyumluluğu	v1 modül dosyaları	v2 uyumlu güncel modül gerekli

Bu değişikliklerin hiçbiri eski sisteminizi otomatik olarak güncellemez. Geçiş e-postanızı aldıktan sonra entegrasyon tarafında el ile yapılandırma güncellemeniz gerekir.

Kontrol Listesi: Destek Talebi Açmadan Önce

Bu 7 maddeyi kontrol edin — sorunların %90'ı burada çözülür:

Tüm bu adımları yaptıktan sonra sorun devam ediyorsa lütfen hata kodunuzu ve modül sürümünüzü belirterek destek ekibimize ulaşın.

Reseller Not Found! Neden Alınır ve Nasıl Çözülür?

Kısa Cevap

"Reseller not found!" hatası, çoğunlukla Username alanına eski metinsel kullanıcı adının girilmesi nedeniyle oluşur. Yeni v2 altyapısında bu alana yalnızca sayısal Reseller ID yazılmalıdır.

Neden Oluşur?

Eski kullanıcı adınızı (örneğin “daynex”, “carlosteck”) Username alanına yazmak

Modülün v2 uyumlu güncel sürümde olmaması — eski modül arka planda eski parametre yapısını gönderiyor

WHMCS geçiş e-postasındaki bilgileri yanlış alana girmek

YANLIŞ ve DOĞRU Kullanım

❌ YANLIŞ

✅ DOĞRU

Username: daynex

Username: 381728

Username: firma@email.com

Username: 994521 (yalnızca rakam)

Password: PanelS1frem!

Password: sk_live_x9Kp2mN7qR4tY8... (API Key)

Çözüm: Adım Adım

Detaylı açıklama: Reseller Not Found Hatası ve Açıklaması

Geçiş sonrası tam kurulum için: Geçiş Sonrası Entegrasyon Rehberi

Henüz ücretsiz bayi hesabınız yok mu?

Domain Name API Registrar API'sini ve domain automation altyapısını 2 dakikada ücretsiz test edebilirsiniz.

Invalid API Key (API_401) Neden Oluşur ve Nasıl Düzeltilir?

Kısa Cevap

API_401 hatası, API kimlik doğrulamasının başarısız olduğunu gösterir. En yaygın iki neden: (1) API Key yerine panel Şifresinin girilmesi, (2) API Key kopyalanırken başında veya sonunda boşluk bırakılması.

Neden Oluşur?

Neden	Belirti
Panel Şifresi girilmiş	API_401 veya 'Username and password combination not correct'
API Key başında/sonunda boşluk var	API_401, özellikle copy-paste sonrası
API Key yenilendi ama modülde eski key var	Bir süre çalıştı, sonra durdu
IP izni yok	API_401 veya Unauthorized hatası

Çözüm: Adım Adım

API Key'i bir tarayıcıdan veya e-postadan kopyaladığınızda, başına veya sonuna otomatik boşluk ekleniyor olabilir. Bu boşluk gözle görünmez ama sistemi bozar. En güvenli yöntem: API Key alanına sağ tıklayıp 'Yapıştır' yerine, önce Notepad/TextEdit'e yapıştırın, boşluk olup olmadığını kontrol edin, sonra oradan kopyalayın.

Detaylı açıklama: Invalid API Key Hatası Sebepleri ve Çözümleri

IP White List Neden Zorunlu ve Nasıl Tanımlanır?

v2 altyapısı, güvenlik gereği yalnızca önceden tanımlanmış IP adreslerinden gelen API isteklerini kabul eder. Sunucunuzun IP'si tanımlı değilse, doğru kimlik bilgilerini girseniz bile sistem bağlantıyı reddeder.

Neden Bu Kadar Kritik?

API erişimini yalnızca belirlenen IP adreslerine kısıtlamak, API Key'in çalınması veya sızması durumunda bile yetkisiz erişimi önler. Bu bir güvenlik özelliğidir, kullanıcıyı zorlamak için değil.

IP White List Nasıl Eklenir?

Dikkat: Sitenizin IP'si ile Sunucunun Çıkış IP'si Farklı Olabilir

Özellikle paylaşımlı hosting veya cloud ortamlarda, sitenizin görünen IP adresi ile sunucunun dışarıya (API sunucumuza) istek gönderirken kullandığı çıkış IP (Gateway/NAT IP) farklı olabilir.

Doğru IP'yi bulmak için: Hosting sağlayıcınıza 'cURL isteklerinde kullandığınız çıkış IP nedir?' diye sorun.

Alternatif: Sunucunuzdan curl https://api.ipify.org komutunu çalıştırarak gerçek çıkış IP'nizi öğrenebilirsiniz.

IP White List eksik olduğunda alınan hata mesajları:

Unauthorized! Invalid API Key

API_401

Reseller not found!

Bağlantı zaman aşımına uğruyor / WHMCS yavaşlıyor (Cloudflare 522)

Detaylı açıklama: Unauthorized API Erişim Hatası Sebepleri ve Çözüm Rehberi

OT&E test platformu: Domain Name API Test Platformu Bilgileri

API bağlantınızı test etmek ister misiniz?

OT&E sandbox platformunda gerçek domain kaydı veya ücret oluşturmadan tüm domain automation akışlarınızı test edebilirsiniz.

Modül Güncellemesi: En Kritik Adım

Tüm sorunların temelinde en sık karşılaşılan neden şudur: eski modül dosyaları hâlâ sunucuda duruyordur. Reseller ID ve API Key'i doğru girseniz bile, eski modül arka planda eski v1 API sunucusuna ve eski parametre yapısıyla istek göndermeye devam eder.

Hangi Modül Sürümü Doğru?

Platform	v2 Uyumlu Minimum Sürüm
WHMCS	V.3.0.9 ve üzeri
WiseCP	V2.0.8 ve üzeri
HostBill	Son sürüm (GitHub üzerinden)
Blesta	Son sürüm
ClientExec	Son sürüm

Modül Nasıl Güncellenir?

Güncel modül dosyaları ve kurulum kılavuzu: Domain Reseller Modül Güncelleme Rehberi

GitHub modül deposu: github.com/domainreseller

WHMCS Registrar API Modülü: WHMCS Entegrasyon Rehberi

WiseCP Domain Management API Modülü: WiseCP Entegrasyon Rehberi

HostBill Modülü: HostBill Entegrasyon Rehberi

Modülünüz eski olabilir.

En güncel WHMCS, WiseCP ve HostBill domain registrar modüllerini indirerek entegrasyonunuzu birkaç dakika içinde güncelleyebilirsiniz.

WHMCS İçin Adım Adım Kurulum

Aşağıdaki adımları sırasıyla uygulayın. Her adımı atlamamak önemlidir.

Username alanına: Sayısal Reseller ID'nizi girin

Password alanına: v2 panelinden oluşturduğunuz API Key'i girin (boşluk kontrolü yapın)

Test Mode: OT&E (sandbox) testleri için işaretleyin; canlı sistem için işaretsiz bırakın

WHMCS Yavaşlıyor veya Cloudflare 522 Hatası Alıyorsanız

Bu durum neredeyse her zaman IP White List eksikliğinden kaynaklanır. WHMCS, arka planda API'ye istek gönderiyor; API sunucumuz bu isteği sessizce reddediyor (DROP). WHMCS yanıt gelmesini beklerken zaman aşımına uğruyor ve tüm sayfa yavaşlıyor.

Geçici çözüm: DomainNameAPI modülünü Deactivate edin. Bu, arka plan isteklerini durdurur ve sayfa hızını anında eski haline getirir. Sonra White List'i ekleyip modülü yeniden aktif edin.

WiseCP İçin Adım Adım Kurulum

Reseller Username / Kullanıcı Adı: Sayısal Reseller ID

Reseller Password / Şifre: API Key (panel şifresi değil)

WiseCP'de Domain Senkronizasyonu Çalışmıyor veya Siparişler İptal Oluyorsa

WiseCP'nin otomatik iptal etme nedeni nedir?

WiseCP, arka planda API'ye istek gönderirken hata alırsa (Reseller not found, Invalid API Key, Unauthorized) domain'in tescil edilemediğini varsayar ve siparişi otomatik olarak 'İptal Edildi' veya 'Başka Yere Transfer Edildi' olarak işaretler.

Bu bir WiseCP güvenlik mekanizmasıdır; Domain Name API sistemi durduk yere iptal etmemektedir.

Çözüm: API bağlantısını düzeltin. Bağlantı sağlandıktan sonra WiseCP üzerinden ilgili siparişi yeniden senkronize edin.

Geçiş sonrası yapılandırma rehberi: Geçiş Sonrası Entegrasyon Rehberi

HostBill: TLD Sürekli Geri Geliyor

Durum

HostBill'de ürün listesinden TLD'leri siliyorsunuz ama cron çalışınca hepsi geri geliyor.

Neden Olur?

HostBill modülü, her senkronizasyon işleminde Domain Name API'den tüm aktif TLD listesini çeker ve panele otomatik olarak ekler. Bu özellik kapatılmadıkça silinen uzantılar her cron döngüsünde geri eklenir.

Çözüm

Bu ayar kapatıldıktan sonra:

Mevcut TLD'lerinizin fiyatları güncellenir

Müşteri domain durumları senkronize edilir

Sildiğiniz veya yeni eklenen TLD'ler otomatik olarak geri gelmez

Domain Yenileme Hatası: Parameter value range error

Hata

WHMCS'de domain yenileme işlemi 'Parameter value range error' ile başarısız oluyor.

Neden Olur?

WHMCS modülünüz eski v1 API adresine istek gönderiyor (api.domainresellerapi.com/api/v1/...). Bu endpoint artık yeni mimari için aktif değil. Sistem parametreleri tanıyamıyor ve bu hatayı döndürüyor.

Çözüm

Modülü V.3.0.9 veya üzeri sürüme güncelleyin.

Eski modül dosyalarını tamamen silin, temiz kurulum yapın.

Yeni modül otomatik olarak doğru v2 endpoint'leri kullanır.

Güncellemeden sonra başarısız olan yenileme işlemlerini WHMCS üzerinden yeniden tetikleyin.

Domain Senkronizasyonu Çalışmıyor: Sebep ve Çözüm

Modülü güncellediniz, Reseller ID ve API Key girdiniz, bağlantı başarılı dönüyor ama domainler senkronize olmuyor. Bu durumda şu sırayla kontrol edin:

Kontrol	Nasıl Kontrol Edilir?	Çözüm
Cron çalışıyor mu?	WHMCS/WiseCP automation log	Cron görevlerinin zamanlamasını düzenleyin
IP White List doğru mu?	Sunucu çıkış IP'sini curl ile kontrol edin	Doğru IP'yi panele ekleyin
API Key boşluk var mı?	Alanı temizle, yeniden yapıştır	Notepad'den kopyalayın
Modül güncel mi?	Modül sürüm bilgisini kontrol edin	V.3.0.9 / V2.0.8 kurulumu yapın
Cron çok sık çalışıyor mu?	429 hatası var mı?	Cron sıklığını azaltın

GetTldList Hatası: Neden Çalışmıyor ve Nasıl Çözülür?

GetTldList metodunu çağırırken hata alıyorsanız, bu durum genellikle şu iki nedenden birinden kaynaklanır:

1. API Bağlantısı Kurulamıyor

GetTldList başarısız oluyorsa, büyük ihtimalle temel bağlantı da kurulamıyor demektir. Önce Reseller ID, API Key ve White List kontrolü yapın. Bağlantı sağlandıktan sonra GetTldList de çalışacaktır.

2. TLD Kataloğunda Veri Uyuşmazlığı (KeyNotFoundException)

Belirli bir TLD uzantısının (örneğin .org.ge, .watches gibi) fiyat veya özellik bilgisi API kataloğumuzda eksik veya hatalı tanımlanmışsa, bu hata tüm TLD listesinin çekilmesini engeller. Bu durum sistem tarafımızdaki bir veri hatasıdır ve müşteri tarafında bir çözümü yoktur.

Bu tür hataları aldığınızda:

Hata mesajının tamamını (hangi TLD, hangi hata kodu) destek ekibimizle paylaşın.

Teknik ekibimiz katalog verisini güncelleyerek sorunu merkezi olarak çözer.

Çözüm sonrası GetTldList metodunuz otomatik olarak çalışmaya devam eder.

Sıkça Sorulan Sorular

Dün çalışıyordu, bugün neden çalışmıyor?

Domain Name API v2 altyapıya geçişini tamamladı. Bu geçişle birlikte kimlik doğrulama yapısı değişti. Artık eski kullanıcı adı ve şifre yerine Reseller ID ve API Key kullanılması gerekiyor.

Reseller ID'mi nereden bulabilirim?

v2 bayi panelinize (dm.apiname.com) giriş yapın. Ana sayfanızda veya profil bölümünüzde tamamen rakamlardan oluşan Reseller ID'nizi göreceksiniz.

API Key ile panel şifresi aynı şey mi?

Hayır. API Key, v2 panelinizin Ayarlar > API Yönetimi bölümünden ayrıca oluşturduğunuz uzun bir güvenlik anahtarıdır. Panel giriş şifrenizden tamamen bağımsızdır.

Her ikisini de doğru girdim, hâlâ hata alıyorum. Ne yapmalıyım?

IP White List kontrolü yapın. Sunucunuzun çıkış IP'si panelde tanımlı değilse, kimlik bilgileri doğru olsa bile sistem bağlantıyı reddeder.

Modülümü güncelledim ama hâlâ eski UserName/Password alanları görünüyor.

Eski modül dosyaları tam olarak silinmemiş olabilir. /modules/registrars/domainnameapi/ dizinini tamamen silin, sonra yeni modülü temiz kurulumla yükleyin.

WiseCP'de bağlantı testi başarılı dönüyor ama TLD'ler ve bakiye gelmiyor.

Sunucu çıkış IP'si White List'te yanlış tanımlanmış olabilir. Sitenizin görünen IP'si ile sunucunun cURL çıkış IP'si farklı olabilir. Hosting sağlayıcınıza gerçek çıkış IP'yi sorun ve panele ekleyin.

HostBill'de sildiğim TLD'ler geri geliyor.

HostBill modülünün 'Auto-Sync TLDs' veya 'Import New TLDs' özelliği açık. Modül ayarlarından bu özelliği kapatın.

API Key'i yeniledim ama hata devam ediyor.

Yeni API Key'i modüle doğru şekilde yapıştırdığınızdan emin olun. Başında veya sonunda boşluk kalmamasına özellikle dikkat edin.

WHMCS domain yenileme 'Parameter value range error' veriyor.

Modül hâlâ eski v1 API adresine istek gönderiyor. Modülü V.3.0.9 veya üzeri sürüme güncelleyin.

OT&E (test) ortamında test yapabilir miyim?

Evet. OT&E ortamında gerçek kayıt veya ücret oluşturmadan tüm API akışlarınızı test edebilirsiniz. Production URL: api.domainresellerapi.com | OT&E URL: ote.domainresellerapi.com

WiseCP'de sipariş tamamlandı ama domain 'başka yere transfer edildi' olarak görünüyor.

WiseCP, API bağlantısı koptuğunda domain'i tescil edemediğini varsayarak siparişi bu şekilde işaretler. API bağlantısını düzeltin, ardından siparişi senkronize edin.

Modül güncel, bilgiler doğru, IP White List tamam — yine de bağlanmıyor.

Bu durumda sunucunuzun cURL, ionCube Loader ve SSL bileşenlerini kontrol edin. PHP 8.x ile uyumlu ionCube Loader'ın kurulu ve aktif olduğundan emin olun. Sorun devam ederse, hata mesajı ve modül sürümüyle destek ekibimize başvurun.

Hata Kodları Hızlı Başvuru Tablosu

Hata Mesajı	En Olası Neden	Önerilen İlk Adım
Reseller not found!	Username alanında eski metinsel kullanıcı adı var	Reseller ID girin
API_401: Unauthorized! Invalid API Key	Panel Şifresi girilmiş veya API Key'de boşluk var	Yeni API Key oluşturun, boşluksuz yapıştırın
Unauthorized API Access	IP White List'te sunucu IP'si tanımlı değil	Sunucu çıkış IP'sini panele ekleyin
Username and password combination not correct	Eski modül v1 yapısını kullanıyor	Modülü güncelleyin (V.3.0.9 / V2.0.8)
Parameter value range error	Modül eski v1 endpoint'ine istek gönderiyor	Modülü temiz kurulumla güncelleyin
KeyNotFoundException: The given key 'xyz' was not present in the dictionary	TLD kataloğunda veri uyuşmazlığı	Destek ekibine hata kodunu iletin
API_429: Too Many Requests	Cron çok sık çalışıyor veya istek sayısı çok yüksek	Cron sıklığını azaltın, istekleri toplaştırın
Domain has been transferred elsewhere	WiseCP API hatayı 'transfer' olarak yorumladı	API bağlantısını düzelt, siparibşi senkronize et
Invalid response received / Response is empty	API isteği düştü (IP engeli veya eski modül)	White List + modül güncellemesi
WHMCS yavaşlıyor / Cloudflare 522	API istekleri IP engeli nedeniyle zaman aşımına uğruyor	Sunucu çıkış IP'sini White List'e ekleyin

Sonuç ve Destek

Domain Name API v2 geçişiyle birlikte gelen kimlik doğrulama ve güvenlik değişiklikleri, ilk bakışta karmaşık görünebilir. Ancak destek taleplerimizin büyük çoğunluğunun dört temel nedenden kaynaklandığını görüyoruz: eski modül kullanımı, Username alanına Reseller ID yerine eski kullanıcı adı girilmesi, API Key yerine panel şifresi kullanılması ve IP White List eksikliği.

Bu rehberde açıklanan adımları sırasıyla uyguladığınızda entegrasyonunuzun sorunsuz çalışması beklenmektedir.

Hâlâ sorun yaşıyorsanız lütfen şu bilgilerle destek ekibimize başvurun:

Daha fazla API örneği ve REST API dokümantasyonu için:

Domain Reseller API'nin tüm endpoint'lerini, domain registration API işlemlerini ve JSON örneklerini Swagger arayüzünden interaktif olarak test edebilirsiniz.