Invalid API Key (Geçersiz API Anahtarı) Hatası: Sebepleri ve Çözümleri
Invalid API Key Hatası Neden Oluşur?
"Invalid API Key" hatası, otomasyon panelinizin (WHMCS, WiseCP, HostBill, Blesta, ClientExec) gönderdiği API kimlik bilgilerinin DomainNameAPI tarafında geçerli/yetkili olarak tanınmamasından kaynaklanır. En sık sebep, hesap taşıma (migration) sonrası eski kullanıcı adı/şifre ile bağlantı kurmaya çalışmak veya Reseller ID ile API Key alanlarının yanlış girilmiş olmasıdır.
1. Giriş
"Invalid API Key" hatası, domain bayilerinin ve hosting firmalarının otomasyon panellerinde en sık karşılaştığı hatalardan biridir. Hata mesajı kısa olsa da arkasında birkaç farklı kök sebep yatabilir: yanlış kopyalanmış bir anahtar, eski bir kimlik bilgisi seti veya panelde ters girilmiş bir alan.
Bu rehberde hatanın neden oluştuğunu, hangi senaryolarda ortaya çıktığını ve WHMCS, WiseCP, HostBill, Blesta, ClientExec panellerinin her birinde nasıl düzeltileceğini adım adım ele alıyoruz.
2. Bu Hata Teknik Olarak Ne Anlama Gelir?
DomainNameAPI'ye gönderilen her istek iki bilgiyi birlikte taşır: Reseller ID (bayi kimliğiniz) ve API Key (kimlik doğrulama anahtarınız). Sistem bu ikiliyi kontrol eder; eşleşme bulunamazsa veya anahtar artık geçerli değilse "Invalid API Key", "Unauthorized" ya da "Authentication Failed" gibi bir hata döner.
Bu iki bilgiye Bayi Ayarları > Entegrasyon Bilgileri sayfasından ulaşılır; sayfada Reseller ID, Canlı Ortam API Anahtarı ve Test Ortamı API Anahtarı olmak üzere üç alan bulunur. Otomasyon panelinizdeki modül ayarlarında bu bilgiler genellikle "Kullanıcı Adı" (Reseller ID) ve "Şifre" (API Key) alanlarına karşılık gelir — bu eşleştirmeyi karıştırmak hatanın en sık görülen sebeplerinden biridir.
3. En Yaygın Sebepler ve Çözümleri
1) Migration Sonrası Eski Kullanıcı Adı/Şifre ile Bağlantı
Hesabınız yeni DomainNameAPI platformuna taşındıysa, eski kullanıcı adı ve şifre kombinasyonuyla yapılan API istekleri artık desteklenmemektedir. Modül hâlâ eski bilgilerle çalışmaya çalışıyorsa sistem isteği reddeder.
Çözüm: Migration tamamlandığında size e-posta ile gönderilen Reseller ID ve API Key bilgilerini kullanarak modül ayarlarındaki kullanıcı adı ve şifre alanlarını güncelleyin. E-postayı bulamıyorsanız Entegrasyon Bilgileri sayfasından "Bilgileri e-posta gönder" butonuyla yeniden gönderebilirsiniz.
DomainNameAPI Teknik Ekibinin Gözlemi
Destek ekibimize ulaşan "Invalid API Key" taleplerinin önemli bir kısmı, migration sonrası hâlâ eski kullanıcı adı/şifre ile çalışan panellerden geliyor. Bu vakalarda modülde hiçbir teknik bozukluk yok; sadece kimlik bilgileri güncellenmemiş oluyor.
2) API Key Kopyalanırken Oluşan Karakter Hatası
API anahtarını panelden kopyalayıp modüle yapıştırırken, başına/sonuna fazladan boşluk veya görünmez bir satır sonu karakteri eklenmesi oldukça yaygındır. Bu durumda anahtar gözle aynı görünse de sistem onu geçersiz sayar.
Çözüm: Anahtarı kopyala-yapıştır yerine, mümkünse panelden tekrar kopyalayıp doğrudan ilgili alana yapıştırın; yapıştırdıktan sonra alanın başında/sonunda boşluk kalmadığından emin olun. Şüpheniz varsa anahtarı manuel olarak yeniden yazın.
3) Reseller ID ve API Key Alanlarının Yer Değişmesi
Modül ayarlarında "Kullanıcı Adı" alanına API Key, "Şifre" alanına Reseller ID girilmesi — yani iki bilginin yer değiştirmesi — sık yapılan bir hatadır. Doğru eşleştirme: Kullanıcı Adı = Reseller ID, Şifre = API Key.
Çözüm: Modül ayarlarını açıp her iki alanı da kontrol edin; Reseller ID'nin kullanıcı adı alanına, API Key'in şifre alanına girildiğinden emin olun.
DomainNameAPI Teknik Ekibinin Gözlemi
"Reseller Not Found" hatalarının önemli bir kısmı, Reseller ID alanına bayi hesabının e-posta adresinin yazılmasından kaynaklanıyor. Reseller ID, e-posta değil; Entegrasyon Bilgileri sayfasındaki ayrı bir alandır ve genellikle uzun bir harf-rakam kombinasyonu şeklindedir.
4) Eski veya Güncellenmemiş Modül Sürümü
Eski bir modül sürümü, güncel API kimlik doğrulama yöntemini desteklemeyebilir. Bu durumda doğru bilgileri girmiş olsanız bile modül isteği yanlış formatta gönderir ve sistem "Authentication Failed" veya "Invalid API Response" döner.
Çözüm: Kullandığınız panele ait en güncel modül dosyasını resmi GitHub deposundan indirip mevcut dosyaların üzerine yükleyin, ardından API bilgilerini yeniden kaydedin.
5) Test Ortamı Anahtarının Canlı Ortamda Kullanılması (veya Tersi)
Entegrasyon Bilgileri sayfasında Canlı Ortam ve Test Ortamı için ayrı API anahtarları bulunur. Test anahtarını canlı modülde, veya canlı anahtarı test ortamında kullanmaya çalışmak kimlik doğrulama hatasına yol açar.
Çözüm: Hangi ortamda çalıştığınızı (canlı/test) doğrulayın ve o ortama ait doğru API anahtarını kullanın.
6) Anahtarın Güvenlik Gereği Yenilenmiş Olması
Eğer anahtarınızı güvenlik amacıyla yeniledikten sonra modül ayarlarını güncellemediyseniz, sistem artık geçersiz olan eski anahtarı reddeder.
Çözüm: Panelinizden güncel API anahtarınızı kontrol edin; yenilediyseniz modül ayarlarındaki şifre alanını yeni anahtarla güncelleyin.
7) IP Whitelist ile İlişkili Görünen Yetkilendirme Hatası
Bazı durumlarda asıl sorun API anahtarı değil, isteğin geldiği sunucu IP'sinin yetkili listede olmamasıdır; ancak panel bu durumu da genel bir "Unauthorized" veya "Invalid API Key" mesajıyla gösterebilir.
Çözüm: API anahtarını doğruladıktan sonra sorun sürüyorsa, sunucunuzun IP adresinin DomainNameAPI panelindeki IP yetkilendirme ayarlarında tanımlı olduğunu kontrol edin.
4. Karar Ağacı: Invalid API Key Hatası Alıyorsanız
"Invalid API Key" hatası alıyorsanız, sırasıyla şu kontrolü uygulayın:
1) Yakın zamanda hesap taşıma (migration) işlemi yaşadınız mı?
• Evet → Eski kullanıcı adı/şifre alanlarını Reseller ID + API Key ile değiştirin.
• Hayır → 2. adıma geçin.
2) API Key'i panelden kopyaladığınızda boşluk/satır sonu karakteri eklenmiş olabilir mi?
• Evet → Anahtarı manuel olarak yeniden yazın.
• Hayır → 3. adıma geçin.
3) Reseller ID, kullanıcı adı alanına; API Key, şifre alanına mı girildi?
• Hayır → Alanları doğru sıraya göre düzeltin.
• Evet → 4. adıma geçin.
4) Test ortamı anahtarını canlı ortamda (veya tersini) mi kullanıyorsunuz?
• Evet → Doğru ortam anahtarını kullanın.
• Hayır → Modül sürümünüzü ve IP whitelist ayarınızı kontrol edin.
5. Panel Bazlı Doğru Alan Eşleştirmesi
Aşağıdaki tablo, her panelde API bilgilerinin nereye ve hangi sırayla girilmesi gerektiğini gösterir:
6. Sık Görülen Hata Mesajları ve Anlamları
"Invalid API Key" hatası bazen farklı panellerde farklı bir mesaj olarak görünebilir. Aşağıdaki tablo en sık karşılaşılan varyasyonları özetler:
7. Panel Bazlı Invalid API Key Hatası ve Modül İndirme Linkleri
Aşağıda her panel için güncel modül dosyalarına doğrudan ulaşabileceğiniz linkler yer almaktadır. Modülünüz eskiyse, önce buradan güncel sürümü indirip API bilgilerinizi yeniden kaydetmeniz önerilir.
WHMCS Invalid API Key Hatası
WHMCS'te bu hata genellikle System Settings > Domain Registrars > DomainNameAPI ekranındaki Username/Password alanlarının yanlış doldurulmasından kaynaklanır. Güncel modülü buradan indirebilirsiniz:
WiseCP Invalid API Key Hatası
WiseCP'te hata, Ürünler/Hizmetler > Alan Adı Tescili > Kurulum/Ayarlar ekranındaki Bayi Kullanıcı Bilgileri alanlarının eski bilgilerle dolu olmasından kaynaklanabilir. Güncel modülü buradan indirebilirsiniz:
HostBill Invalid API Key Hatası
HostBill'de Settings > Modules > Domain Registrars > DomainNameAPI ekranındaki kimlik bilgileri kontrol edilmelidir. Güncel modülü buradan indirebilirsiniz:
Blesta Invalid API Key Hatası
Blesta'da Settings > Company > Modules > Domain Name API > Manage ekranından ilgili hesap satırındaki Reseller ID/API Key bilgileri yeniden girilmelidir. Güncel modülü buradan indirebilirsiniz:
ClientExec Invalid API Key Hatası
ClientExec'te Settings > Plugins > Registrars > DomainNameAPI ekranındaki kimlik doğrulama alanlarının eski kullanıcı adı/şifre içerip içermediği kontrol edilmelidir. Güncel modül dosyalarına Domain Name API'nin resmi GitHub organizasyon sayfasından ulaşabilirsiniz.
8. API Anahtarınızı Güvenli Saklama
API anahtarınız hesabınıza tam yetkili erişim sağlayan kritik bir bilgidir. Aşağıdaki pratikler hem güvenliği artırır hem de "Invalid API Key" hatalarının bir kısmını önler:
- API anahtarını uygulamanızın ortam değişkenlerine (.env) kaydedin; kaynak koduna doğrudan yazmayın.
- Kod deponuza .gitignore ekleyerek .env dosyasının yüklenmesini engelleyin.
- Sunucu taraflı uygulamalarda şifrelenmiş bir anahtar kasası (Vault, AWS Secrets Manager vb.) kullanın.
- API çağrılarını yalnızca güvenilir IP adreslerine kısıtlayın.
- Anahtarı e-posta, mesajlaşma uygulaması veya ekran görüntüsünde paylaşmayın; GitHub gibi açık kod depolarına yüklemeyin.
- Anahtarınızın ele geçirildiğinden şüpheleniyorsanız destek ekibiyle iletişime geçip anahtarı hemen yeniletin ve tüm uygulamalarınızı güncelleyin.
9. Sıkça Sorulan Sorular
1. API anahtarımı doğru girdiğimden eminim, hâlâ hata alıyorum. Ne yapmalıyım?
Anahtarı manuel olarak yeniden yazın (kopyala-yapıştırdan kaynaklanan gizli karakterleri elemek için), Reseller ID/API Key alanlarının yer değişmediğini kontrol edin ve modül sürümünüzün güncel olduğunu doğrulayın. Bu üçü de doğruysa IP yetkilendirmenizi kontrol edin.
2. Reseller ID ile API Key arasındaki fark nedir?
Reseller ID bayi kimliğinizi tanımlar ve modülde kullanıcı adı alanına girilir; API Key ise kimlik doğrulama anahtarınızdır ve şifre alanına girilir. Her DomainNameAPI isteğinde ikisi birlikte gönderilir.
3. Test ortamı API anahtarı ile canlı işlem yapılabilir mi?
Hayır. Test ortamı anahtarı yalnızca geliştirme/entegrasyon testleri içindir, gerçek kayıt oluşturmaz ve ücretlendirilmez. Canlı işlemler için Canlı Ortam API Anahtarınızı kullanmanız gerekir.
4. Migration sonrası e-postayı bulamıyorum, API bilgilerime nasıl ulaşırım?
Bayi panelinizde Hesabım > Bayi Ayarları > Entegrasyon Bilgileri sekmesine giderek Reseller ID ve API Key'inizi görebilir, "Bilgileri e-posta gönder" butonuyla kayıtlı adresinize yeniden gönderebilirsiniz.
5. Modülü güncellemek API anahtarımı veya domainlerimi etkiler mi?
Hayır. Modül dosyalarını güncellemek yalnızca panel ile API arasındaki bağlantı katmanını değiştirir; mevcut API bilgileriniz, domainleriniz ve müşteri verileriniz bu işlemden etkilenmez.
6. "Unauthorized" ve "Invalid API Key" aynı şey mi?
Çoğunlukla aynı kök sebebi (geçersiz veya tanınmayan kimlik bilgisi) işaret eder, ancak "Unauthorized" bazen IP yetkilendirme sorununu da kapsayabilir. İkisini de aynı kontrol sırasıyla (anahtar → alan eşleştirmesi → IP) ele almak güvenlidir.
7. API anahtarımı ne sıklıkla yenilemeliyim?
Sabit bir kural yoktur, ancak güvenlik amacıyla düzenli aralıklarla (örneğin altı ayda bir) yenilemeniz ve her yenilemede modül ayarlarınızı güncellemeniz önerilir.
8. Birden fazla panel (örneğin WHMCS ve WiseCP) kullanıyorsam aynı API anahtarını her ikisinde de kullanabilir miyim?
Evet, aynı Reseller ID ve API Key birden fazla panelde kullanılabilir. Ancak güvenlik ve izlenebilirlik açısından her panel için ayrı bir alt bayi/anahtar yapısı tercih edilebilir; bu konuda destek ekibimizden bilgi alabilirsiniz.
9. API anahtarımın ele geçirildiğinden şüpheleniyorum, ilk yapmam gereken ne?
Hemen destek ekibimizle iletişime geçip anahtarınızı yeniletin, ardından kullandığınız tüm panellerde (WHMCS, WiseCP, HostBill, Blesta, ClientExec) yeni anahtarı güncelleyin.
10. Eski cp.domainnameapi.com hesabımın kullanıcı adı/şifresiyle hâlâ bağlanabilir miyim?
Hesabınız yeni platforma taşındıysa hayır; eski kullanıcı adı/şifre kombinasyonuyla yapılan istekler artık desteklenmemektedir. Reseller ID ve API Key bilgilerinizi kullanmanız gerekir.
11. Modül ayarlarında "Şifre" alanı görmüyorum, sadece "API Key" yazıyor — ne yapmalıyım?
Bazı paneller alan adını "Şifre" yerine doğrudan "API Key" veya "Token" olarak gösterebilir. Bu durumda o alana API Key'inizi, kullanıcı adı alanına da Reseller ID'nizi girmeniz yeterlidir; mantık aynıdır.
12. API bağlantımı 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; bu en hızlı doğrulama yöntemidir.
13. Yeni bir alt bayi (sub-reseller) oluşturduğumda kendi API anahtarı olur mu?
Evet, her alt bayi hesabının kendine ait Reseller ID ve API Key bilgileri bulunur; bu bilgiler ana hesabınızdan bağımsızdır ve ayrı şekilde yapılandırılmalıdır.
10. Sonuç
"Invalid API Key" hatası, görünüşte tek bir mesaj olsa da arkasında birkaç farklı ve tahmin edilebilir sebep yatar: migration sonrası güncellenmemiş kimlik bilgileri, kopyalama hatası, yer değişmiş alanlar, eski modül sürümü veya yanlış ortam anahtarı. Bu rehberdeki sırayı takip ettiğinizde sorunu genellikle birkaç dakika içinde çözebilirsiniz.
Sorun devam ederse modül log kayıtlarınızı inceleyerek veya destek ekibimize başvurarak hızlıca yardım alabilirsiniz.
DomainNameAPI ile 200'den fazla ülkede alan adı satabilir, WHMCS, WiseCP, HostBill, Blesta ve ClientExec entegrasyonlarını dakikalar içinde tamamlayabilirsiniz.
Domain bayilik programı
Ücretsiz bayi hesabı oluşturmak için Domain Bayilik Programı sayfamızı ziyaret edin.
