Reseller Hosting’de WHM API Nasıl Kullanılır

Son gözden geçirme: Eylül 2026 · WHM (WebHost Manager) resmi dokümanına göre

Reseller WHM API kullanımı için ne işe yarar

WHM’in whmapi1 arayüzü, panelde tek tek tıklayarak yaptığınız hesap ve paket işlemlerini (hesap listeleme, kullanım verisi çekme, paket bilgisi sorgulama gibi) bir betikten ya da kendi yazılımınızdan çağırmanızı sağlar. Çok sayıda müşteri hesabını elle takip etmek yerine, bayi olarak kendi faturalama ya da izleme sisteminizi bu API’ye bağlayabilirsiniz.

Bu API sunucu tarafı bir WHM özelliğidir ve yalnızca reseller/bayi hesabınızın WHM erişimiyle kullanılır; paylaşımlı hosting hesabınız (cPanel kullanıcısı) için whmapi1 kullanılamaz, o düzeyde cPanel’in kendi kullanıcı API’si geçerlidir. Reseller hesabınızın gündelik yönetimini (hesap açma, düzenleme, askıya alma) Bayi Hesabı Yönetimi kartında anlattık; bu kart yalnızca API erişimine odaklanır.

Adım adım reseller WHM API kullanımı

1. WHM’e giriş yapın. Tarayıcıda sunucunuzun WHM adresini açıp bayi kullanıcı adı ve şifrenizle oturum açın.

   Beklenen sonuç: WHM ana ekranında Güvenlik Merkezi ve Geliştirme bölümleri görünür.

2. API Jetonlarını Yönet ekranını açın. Yeni bir jeton oluşturup jetona bir isim verin, gerekiyorsa yalnızca belirli fonksiyonlarla sınırlı bir kapsam seçin.

   Dikkat

   Jeton yalnızca oluşturulduğu anda tam olarak gösterilir; kaydetmezseniz tekrar göremezsiniz. Jeton sızarsa aynı ekrandan hemen iptal edin (revoke).

   Beklenen sonuç: jeton bir kez gösterilir ve listede oluşturma tarihiyle birlikte görünür.

3. API Kabuğu’ndan deneyin. Geliştirme bölümündeki API Kabuğu ekranına girip listaccts gibi bilinen bir whmapi1 fonksiyonunu parametresiz çalıştırın.

   Beklenen sonuç: ekranda JSON biçiminde bir yanıt görürsünüz; bu, gerçek isteklerde alacağınız çıktının aynısıdır.

4. Jetonu isteğinize ekleyin. Kendi betiğinizden HTTPS üzerinden ilgili whmapi1 fonksiyonuna istek atarken jetonu Authorization: whm kullanıcı_adı:jeton başlığıyla gönderin.

   Beklenen sonuç: istek, panelde elle tıklayarak aldığınızla aynı JSON yanıtı döner.

5. Sonucu doğrulayın. API Jetonlarını Yönet ekranında jetonun “son kullanım” bilgisinin güncellendiğini kontrol edin.

   Beklenen sonuç: jetonun son kullanım tarihi, az önce gönderdiğiniz isteğin saatiyle eşleşir.

WHM’in resmi dokümanına göre bir API jetonu, kullanıcı adı ve şifre yerine geçen, kapsamı daraltılabilen ve istendiğinde iptal edilebilen bir kimlik doğrulama yöntemidir.

API Kabuğu belgesine göre bu ekran, gerçek bir istek göndermeden önce whmapi1 fonksiyonlarını ve parametrelerini panelde deneyip yanıt biçimini görmenizi sağlar.

Doğrulama

Hâlâ çözülmediyse

• İstek 401 ya da yetkisiz hatası döndürüyor. Jetonun süresinin dolmadığını ve doğru kullanıcı adıyla eşleştiğini API Jetonlarını Yönet ekranından kontrol edin.
• API Kabuğu’nda fonksiyonu bulamıyorsunuz. Fonksiyon adını (örn. listaccts) birebir yazdığınızdan emin olun; whmapi1 fonksiyon adları büyük/küçük harfe duyarlıdır.
• WHM’de Geliştirme bölümünü göremiyorsunuz. Bu, WHM erişiminizin ACL ile sınırlandırıldığı anlamına gelir; yetki genişletme için destek talebi açın.
• Paylaşımlı hosting hesabınızda whmapi1 kullanmaya çalışıyorsunuz. Bu API yalnızca WHM/reseller düzeyinde çalışır; cPanel hesabı için destek talebiyle uygun yöntemi sorun.