Reseller Hosting API ve OT&E Test Ortamı Kullanım Rehberi

Bir hosting siparişinden sonra hesabı manuel oluşturmak zaman kaybettirir. Paket seçimi, hesap oluşturma ve sipariş doğrulama işlemleri farklı ekranlarda yapıldığında hata riski de artar.

Domain Name API Reseller Hosting REST API, hosting planlarını kendi satış sisteminize aktarmanızı, yeni hosting hesabı oluşturmanızı ve oluşturulan hesabı doğrulamanızı sağlar. Entegrasyonunuzu canlıya almadan önce OT&E ortamında test edebilirsiniz.

Reseller Hosting API Kimler İçin Uygundur?

• Hosting şirketleri
• Domain bayileri
• Web tasarım ve yazılım ajansları
• SaaS ve müşteri paneli geliştiren ekipler
• BT danışmanları ve MSP'ler
• Birden fazla müşteri web sitesini yöneten platformlar

Yalnızca tek bir kişisel web sitesi barındıracaksanız standart hosting daha basit olabilir. Reseller Hosting API, birden fazla müşteriye kendi markası altında hosting satan işletmeler için daha uygundur.

Hosting API Entegrasyonu Ne Kazandırır?

Daha hızlı provizyon

Müşteri ödemesi onaylandıktan sonra hosting hesabı manuel operasyon beklemeden oluşturulabilir.

Daha az veri giriş hatası

Plan ve sipariş bilgileri tanımlı bir entegrasyon akışı üzerinden iletilir. Bu yaklaşım yanlış paket seçimi ve eksik bilgi riskini azaltır.

Tek bir müşteri deneyimi

Domain ve hosting hizmetleri aynı satış veya müşteri panelinde sunulabilir. Müşteri sipariş durumunu tek panelden takip edebilir.

Kontrollü büyüme

Aynı entegrasyon akışı artan sipariş hacminde tekrar kullanılabilir. Uygulama, API limitlerine ve güvenli tekrar deneme kurallarına uygun tasarlanmalıdır.

Entegrasyon testi

OT&E ortamı, Production kimlik bilgilerini ve gerçek müşteri siparişlerini kullanmadan entegrasyon senaryolarını test etmenizi sağlar.

Canlı ve OT&E Ortamları

Ortam	Kullanım Amacı	Swagger / Dokümantasyon
Canlı (Production)	Gerçek işlemler	https://api.domainresellerapi.com/swagger/index.html
OT&E (Test)	Entegrasyon ve senaryo testleri	https://ote.domainresellerapi.com/swagger/index.html

OT&E ve Production erişiminin genel yapısı için Domain Name API Test Platformu Bilgileri rehberini inceleyebilirsiniz.

API Kimlik Bilgileri Nereden Alınır?

REST API bağlantısında panel giriş e-postası ve panel şifresi kullanılmaz. Gerekli bilgiler bayi panelindeki Entegrasyon Bilgileri bölümünde bulunur:

• Canlı ortam: Reseller ID ve API Key
• OT&E ortamı: OT&E Reseller ID ve OT&E API Key

Bayi paneli: https://dm.apiname.com/

Canlı ve test bilgilerini karıştırmayın. Ortam ile anahtarın eşleşmemesi yetkilendirme hatasına neden olabilir. IP Whitelist kullanılıyorsa isteği gönderen sunucunun sabit IP adresini panelde tanımlayın.

Reseller Hosting API Endpointleri

Metot	Endpoint	Temel Amaç
GET	/api/v1/hostings/plans	Kullanılabilir hosting planlarını listeler.
POST	/api/v1/hostings/create	Bayi hesabı altında yeni bir hosting hesabı oluşturur.
GET	/api/v1/hostings	Bayi hesabına bağlı hosting hesaplarını listeler.
GET	/api/v1/hostings/by-token	Belirtilen token ile tek bir hosting hesabını sorgular.

Zorunlu alanlar, veri tipleri, filtreler, sayfalama seçenekleri ve yanıt modelleri için güncel Swagger şeması esas alınmalıdır. Endpoint adından hareketle alan veya yanıt biçimi tahmin edilmemelidir.

Hosting Sipariş Yaşam Döngüsü

1. Güncel hosting planlarını alın

GET /api/v1/hostings/plans ile kullanılabilir planları alın. Yeni hesap oluştururken kullanılacak geçerli plan bilgisini bu yanıttan seçin.

Plan adı, kaynak limitleri, fiyat veya diğer alanların kesin isimlerini Swagger'dan doğrulayın. Plan bilgilerini kalıcı olarak sabit kodlamak yerine belirli aralıklarla API'den güncelleyin.

2. Müşteri siparişini doğrulayın

Hosting hesabı oluşturmadan önce şu kontrolleri tamamlayın:

• Ödeme onaylandı mı?
• Sipariş daha önce işlendi mi?
• Seçilen plan hâlâ kullanılabilir mi?
• Domain ve müşteri bilgileri gerekli formatta mı?
• Aynı sipariş için aktif bir hosting hesabı var mı?

3. Hosting hesabını oluşturun

POST /api/v1/hostings/create endpoint'ine Swagger'da tanımlanan zorunlu alanlarla istek gönderin. Başarılı yanıtta dönen hesap kimliğini veya token'ı kendi sipariş kaydınızla ilişkilendirin.

Domain, plan, kullanıcı, iletişim veya şifre alanlarının bulunup bulunmadığını ve kesin isimlerini Swagger'dan doğrulayın.

4. Hesabı token ile doğrulayın

GET /api/v1/hostings/by-token ile hesabı tekil olarak sorgulayın. Müşteriye 'Hosting hesabınız hazır' mesajını yalnızca oluşturma yanıtı ve hesap durumu beklenen sonucu verdiğinde gösterin.

Ağ bağlantısının kesilmesi her zaman işlemin başarısız olduğu anlamına gelmez. Aynı create isteğini kontrol etmeden tekrar göndermek mükerrer hesap oluşturabilir.

5. Hesapları listeleyin ve senkronize edin

GET /api/v1/hostings ile bayi hesabına bağlı hosting hesaplarını alın. Filtre, sayfalama ve yanıt alanlarının desteklenip desteklenmediğini Swagger'dan doğrulayın.

Listeleme çağrısı; operasyon ekranını güncellemek, müşteri panelinde durum göstermek, envanter kontrolü yapmak ve yerel kayıtları API kayıtlarıyla karşılaştırmak için kullanılabilir.

Gerçek Bir Müşteri Siparişinde Akış

1. Müşteri bir hosting paketi seçer.
2. Uygulama seçimi güncel /plans yanıtıyla eşleştirir.
3. Ödeme onaylandıktan sonra yerel sipariş kaydı oluşturulur.
4. /create isteği yerel sipariş referansıyla ilişkilendirilir.
5. API yanıtındaki hesap kimliği veya token güvenli biçimde kaydedilir.
6. /by-token ile hesabın oluştuğu doğrulanır.
7. Başarılı doğrulamadan sonra müşteri bilgilendirilir.
8. /hostings ile periyodik senkronizasyon yapılır.

Önerilen OT&E Test Planı

1. OT&E kimlik bilgileriyle bağlantı kurun.
2. /plans ile kullanılabilir test planlarını alın.
3. Geçerli bir planla /create isteği gönderin.
4. Dönen hesap kimliği veya token'ı saklayın.
5. /by-token ile hesabı doğrulayın.
6. /hostings ile hesabın listede göründüğünü kontrol edin.
7. Geçersiz plan ve eksik alan senaryolarını test edin.
8. Yetkisiz erişim ve IP Whitelist hatasını test edin.
9. Zaman aşımında ikinci hesap oluşmadığını doğrulayın.
10. Aynı siparişin iki kez işlenmesini önleyin.
11. API hatalarını kullanıcı dostu mesajlara dönüştürün.
12. Loglarda API Key, token, şifre veya kişisel veri bulunmadığını kontrol edin.

OT&E testleri tamamlandıktan sonra yalnızca base URL ve ilgili ortama ait kimlik bilgilerini değiştirerek canlı ortama geçin.

Güvenli ve Ölçeklenebilir Entegrasyon

Plan bilgilerini sabit kodlamayın

Plan kimliği, kaynak bilgisi ve fiyat gibi alanları API'nin güncel yapısı üzerinden yönetin. Plan kataloğu değiştiğinde entegrasyonun çalışması için düzenli senkronizasyon kullanın.

Mükerrer hesapları önleyin

Her sipariş için benzersiz bir yerel referans oluşturun. create çağrısında zaman aşımı yaşanırsa yeni hesap açmadan önce önceki işlemin sonucunu sorgulayın.

Hassas verileri koruyun

API Key, müşteri bilgileri, hosting şifresi ve token'lar yalnızca sunucu tarafında işlenmelidir. Loglarda hassas alanları maskeleyin.

Doğrulanmış durum gösterin

Yalnızca HTTP isteğinin başarılı dönmesine güvenmeyin. Hesabın beklenen durumda olduğunu doğrulayın ve müşteriye anlaşılır bir durum mesajı gönderin.

İstek limitlerine uyun

API isteklerini kuyruklayın. 429 Too Many Requests yanıtında kontrollü geri çekilme uygulayın. Kesin limiti güncel API dokümantasyonundan kontrol edin.

Sık Karşılaşılan API Sorunları

Sorun	İlk Kontrol Noktası
401 Unauthorized	Reseller ID, API Key, ortam eşleşmesi ve IP Whitelist
403 Forbidden	Hesap yetkisi, ürün erişimi ve kullanılan ortam
400 Bad Request	Swagger'daki zorunlu alanlar ve veri biçimleri
404 Not Found	Endpoint, token veya sorgulanan kaynak
429 Too Many Requests	İstek sıklığı, kuyruklama ve geri çekilme
Zaman aşımı veya 5xx	Yeni hesap açmadan önce mevcut işlemin kontrolü

İlgili Rehberler

• Domain Name API Test Platformu Bilgileri

• SSL Reseller API ve OT&E Test Rehberi

• Reseller Hosting Programı

• Bayi paneli

Sıkça Sorulan Sorular

OT&E ortamında gerçek hosting hesabı açılır mı?

OT&E test amaçlıdır. OT&E kaynaklarını Production işlemi olarak kabul etmeyin. Canlı işlemlerde Production adresini ve Production kimlik bilgilerini kullanın.

Önce hangi endpoint çağrılmalıdır?

Geçerli planları görmek için önce GET /api/v1/hostings/plans kullanılması önerilir. Ardından seçilen planla hesap oluşturulur.

İstek alanlarını nereden görebilirim?

En güncel zorunlu alanlar, veri tipleri ve örnek modeller Production veya OT&E Swagger sayfasında bulunur.

Create sonrasında hesabı neden sorgulamalıyım?

Hesabın güncel durumunu doğrulamak yanlış başarı mesajını ve mükerrer hesap riskini azaltır.

WHMCS veya WiseCP kullanıyorsam REST API gerekli mi?

Kullandığınız modülün reseller hosting işlemlerini destekleyip desteklemediğini güncel modül dokümantasyonundan kontrol edin. Hazır modül ihtiyacınızı karşılıyorsa doğrudan REST API geliştirmesi gerekmeyebilir.

Canlı ve OT&E anahtarları aynı mı?

Hayır. Her ortam için panelde gösterilen ilgili Reseller ID ve API Key kullanılmalıdır.

Sonuç

İyi bir reseller hosting entegrasyonu yalnızca hesap açan bir create çağrısından ibaret değildir. Güncel planı seçmek, sonucu token ile doğrulamak, hassas bilgileri korumak ve belirsiz ağ hatalarında mükerrer işlem oluşturmamak aynı akışın parçalarıdır. Bu kontrolleri OT&E ortamında tamamladığınızda canlıya daha az operasyonel riskle geçebilirsiniz.