SetCloud Hosting API: Hosting, Domain, DNS ve Fatura İşlemlerini Otomatik Yönetin
Hosting, domain ve bulut hizmetlerini yönetmek için her işlemde müşteri paneline giriş yapmak zorunda değilsiniz. SetCloud Hosting API, müşteri hesabınızda erişim izni verilen işlemleri kendi yazılımınızdan, mobil uygulamanızdan, yönetim panelinizden veya otomasyon sisteminizden gerçekleştirmenize yardımcı olan REST API çözümüdür.
API üzerinden hesap ve iletişim bilgilerinizi görüntüleyebilir, faturalarınızı takip edebilir, destek taleplerinizi yönetebilir, domain ve DNS işlemleri gerçekleştirebilir, SSL sertifikası siparişlerini izleyebilir ve uygun ürünlerde hizmet siparişi oluşturabilirsiniz. Proxmox tabanlı desteklenen sanal sunucu hizmetlerinde ise sanal makine oluşturma, başlatma, durdurma, yeniden kurma, IP ve ağ arayüzü yönetimi gibi işlemler de otomasyona bağlanabilir.
SetCloud Hosting API özellikle yazılım geliştiriciler, dijital ajanslar, kurumsal BT ekipleri, çok sayıda domain yöneten işletmeler ve kendi müşteri deneyimini geliştirmek isteyen kullanıcılar için uygundur.
Önemli: API, SetCloud yönetici paneline erişim sağlamaz. Her kullanıcı yalnızca kendi müşteri hesabına, kendisine bağlı hizmetlere ve erişime açılmış yöntemlere ulaşabilir. Kullanılabilir fonksiyonlar; hesap yetkisine, ürün türüne, hizmet durumuna ve API yapılandırmasına göre değişebilir.
Hosting API nedir?
Hosting API, hosting sağlayıcısının müşteri panelinde bulunan belirli işlevleri yazılımların kullanabileceği standart HTTP uç noktaları üzerinden sunmasıdır. Böylece panelde elle yapılan tekrarlı işlemler, güvenli ve denetlenebilir iş akışlarıyla otomatik hale getirilebilir.
Örneğin:
-
Bir ajans, yönettiği domainlerin nameserver, yenileme ve transfer kilidi bilgilerini kendi panelinde gösterebilir.
-
Bir şirket, SetCloud hesabındaki hizmetleri ve faturaları kurum içi uygulamasına aktarabilir.
-
Bir yazılım, uygulama kurulumu sırasında gerekli DNS kayıtlarını otomatik oluşturabilir.
-
Bir destek sistemi, SetCloud taleplerini listeleyebilir ve mevcut talebe yanıt gönderebilir.
-
Bir bulut yönetim paneli, desteklenen Proxmox sanal makinelerini başlatabilir, durdurabilir veya yeniden kurabilir.
SetCloud API, müşteri odaklı bir User API yapısıdır. Bu nedenle HostBill Admin API ile karıştırılmamalıdır. Admin API tüm platformun yönetimine yönelikken User API, oturum açan müşterinin kendi kaynaklarıyla sınırlandırılır.
SetCloud Hosting API ile neler yapılabilir?
API kapsamı yalnızca hosting hizmeti listelemekten ibaret değildir. Panelde etkin görünen yöntemler; müşteri hesabından faturalandırmaya, domain ve DNS yönetiminden Proxmox sanal sunucu işlemlerine kadar geniş bir alanı kapsar.
| API kategorisi | Desteklenen başlıca işlemler |
|---|---|
| Kimlik doğrulama | Giriş, MFA doğrulama, token yenileme, token iptali ve güvenli çıkış |
| Müşteri hesabı | Profil ayrıntıları, profil güncelleme, kullanıcı işlem geçmişi ve ek iletişim kişileri |
| Satış ortaklığı | Özet, kampanya, komisyon, ödeme, kupon ve komisyon planı bilgileri |
| Faturalandırma | Bakiye, fatura listesi, fatura ayrıntısı, kredi uygulama, ödeme yöntemleri, bakiye ekleme ve PDF fatura |
| Destek | Talep listeleme, ayrıntı, ek dosya, yeni talep, yanıt, yeniden açma ve kapatma |
| Domain | Müsaitlik, TLD, kayıt, yenileme, nameserver, kilit, EPP, iletişim, yönlendirme ve DNSSEC |
| DNS | DNS zonu ve kayıtlarını listeleme, oluşturma, düzenleme ve silme |
| SSL sertifikaları | Ürün listeleme, sipariş, sertifika ayrıntısı ve sertifika indirme |
| Hizmetler | Hizmet listesi, ayrıntı, etiket, yenileme, iptal, dönem değişikliği ve yükseltme |
| Sepet ve sipariş | Ürün kategorileri, ürün yapılandırması, tekli/çoklu sipariş ve fiyat teklifi |
| Bildirim ve içerik | Panel bildirimleri, duyurular ve bilgi bankası içerikleri |
| Proxmox sanal sunucu | VM yaşam döngüsü, IP, ağ arayüzü, işletim sistemi şablonu, kaynak ve yükseltme yönetimi |
Desteklenen SetCloud API yöntemleri
Aşağıdaki katalog, 15 Ağustos 2026 tarihinde SetCloud müşteri panelinde görünen API yöntemlerine göre hazırlanmıştır. Görselde toplam 137 yöntem bulunur; bunların 135’i etkin, yalnızca Signup ve Password Reset yöntemleri devre dışıdır. Yöntem adları, etkileşimli dokümantasyonda kolayca eşleştirilebilmesi için İngilizce adlarıyla verilmiştir.
API yöneticisi yöntemleri etkinleştirebilir, devre dışı bırakabilir veya route alias tanımlayabilir. Bu nedenle entegrasyonda kullanılacak kesin HTTP yöntemi, yol ve parametreler için müşteri panelindeki güncel etkileşimli API dokümantasyonu esas alınmalıdır.
1. Kimlik doğrulama ve token yönetimi
| Yöntem | Durum | İşlev |
Login |
Etkin | Kullanıcı doğrulaması yaparak API oturumu başlatır. |
Request MFA |
Etkin | Çok faktörlü doğrulama sürecini başlatır. |
Verify MFA |
Etkin | Kullanıcının gönderdiği MFA kodunu doğrular. |
Logout |
Etkin | Geçerli API oturumunu sonlandırır. |
Refresh Token |
Etkin | Erişim tokenini güvenli biçimde yeniler. |
Revoke Token |
Etkin | Geçerli tokenin kullanımını iptal eder. |
Signup |
Devre dışı | API üzerinden yeni müşteri kaydı SetCloud yapılandırmasında kapalıdır. |
Password Reset |
Devre dışı | API üzerinden parola sıfırlama SetCloud yapılandırmasında kapalıdır. |
MFA etkin hesaplarda yalnızca kullanıcı adı ve parola ile doğrudan erişim yeterli olmayabilir. Entegrasyonun Request MFA ve Verify MFA adımlarını desteklemesi gerekir. Tokenlar kaynak koduna, herkese açık depolara veya uygulama loglarına yazılmamalıdır.
2. Müşteri hesabı ve işlem geçmişi
| Yöntem | İşlev |
User Details |
Oturum açan müşterinin izin verilen hesap bilgilerini getirir. |
Update User Details |
Güncellenmesine izin verilen müşteri bilgilerini değiştirir. |
User Logs |
Müşterinin erişimine açık hesap işlem geçmişini listeler. |
Bu yöntemler, kurum içi uygulamalarda müşteri profili ve hesap geçmişi ekranları oluşturmak için kullanılabilir.
3. Satış ortaklığı yöntemleri
| Yöntem | İşlev |
Get Affiliate summary |
Satış ortaklığı hesabının özetini getirir. |
Get Affiliate campaigns |
Kullanılabilir satış ortaklığı kampanyalarını listeler. |
Get Affiliate commissions |
Hak edilen veya işlenen komisyonları listeler. |
Get Affiliate payouts |
Satış ortaklığı ödeme kayıtlarını gösterir. |
Get Affiliate vouchers |
Hesaba tanımlı satış ortaklığı kuponlarını listeler. |
Get Affiliate commission plans |
Kullanılabilir komisyon planlarını getirir. |
Satış ortaklığı fonksiyonları, yalnızca ilgili programın hesabınız için açık olması durumunda anlamlı veri döndürür.
4. Ek iletişim kişileri ve yetkiler
| Yöntem | İşlev |
List contacts |
Müşteri hesabına bağlı iletişim kişilerini listeler. |
Add contact |
Hesaba yeni bir iletişim kişisi ekler. |
Contact privileges |
İletişim kişilerine atanabilecek yetki türlerini listeler. |
Get contacts details |
Belirli bir iletişim kişisinin ayrıntılarını getirir. |
Edit contact |
İletişim kişisinin izin verilen bilgilerini ve yetkilerini günceller. |
Bu yapı; teknik, muhasebe veya yönetim ekipleri için ayrı iletişim kişileri bulunan kurumsal hesaplarda süreçleri kolaylaştırır.
5. Bakiye, fatura ve ödeme yöntemleri
| Yöntem | İşlev |
Account balance |
Müşteri hesabının kullanılabilir bakiye bilgisini getirir. |
List Invoices |
Hesaba ait faturaları listeler. |
Invoice Details |
Belirli bir faturanın ayrıntılarını ve durumunu getirir. |
Apply credit |
Uygun koşullarda hesap kredisini seçilen faturaya uygular. |
Payment Methods |
Kullanılabilir ödeme yöntemlerini listeler. |
Payment Methods Fees |
Ödeme yöntemlerine ait uygulanabilir ücret bilgilerini getirir. |
Get Add Funds Information |
Hesaba bakiye eklemek için gerekli limit ve yöntem bilgilerini getirir. |
Add Funds |
Uygun hesaplarda bakiye ekleme sürecini başlatır. |
Invoice PDF |
Belirli bir faturanın PDF verisine erişim sağlar. |
Faturalandırma API’si, şirket içi raporlama ve ödeme hatırlatma sistemleriyle entegrasyon kurulmasını kolaylaştırır. API yanıtları resmi muhasebe belgesinin yerine geçmez; yasal kayıtlar için müşteri panelindeki fatura ve belgeler esas alınmalıdır.
6. Destek talepleri
| Yöntem | İşlev |
List Tickets |
Müşteri hesabındaki destek taleplerini listeler. |
Ticket details |
Belirli bir talebin ayrıntılarını ve yanıt geçmişini getirir. |
Ticket attachment |
Talebe bağlı, erişim izni bulunan dosyayı indirir. |
Create Ticket |
Yeni destek talebi oluşturur. |
Create Reply |
Mevcut destek talebine yanıt gönderir. |
Re-open ticket |
Uygun durumdaki kapalı talebi yeniden açar. |
Close ticket |
Açık destek talebini kapatır. |
List ticket departments |
Talep oluşturulabilecek destek departmanlarını listeler. |
Destek API yöntemleri sayesinde SetCloud talepleri, kurum içi yardım masası veya mobil uygulama üzerinden takip edilebilir.
7. Domain sorgulama, kayıt ve yönetim yöntemleri
| Yöntem | İşlev |
List Domains |
Müşteri hesabındaki domainleri listeler. |
Domain details |
Domain kimliğine göre ayrıntıları getirir. |
Domain details by name |
Alan adına göre domain ayrıntılarını getirir. |
Get domain nameservers |
Domain üzerinde tanımlı nameserver adreslerini gösterir. |
Update domain nameservers |
Domainin nameserver adreslerini günceller. |
Get registered nameservers |
Domain altında kayıtlı özel nameserver/child host bilgilerini getirir. |
Register domain nameservers |
Desteklenen uzantılarda özel nameserver kaydı oluşturur veya yönetir. |
DNS Records (DNS Hosting) |
Domain ile ilişkili kayıtlı DNS kayıtlarını listeler. |
Create DNS Records |
Domain için desteklenen yeni DNS kaydını oluşturur. |
Update DNS Records |
Mevcut domain DNS kaydını günceller. |
Remove DNS Records |
İzin verilen domain DNS kaydını siler. |
DNS Records Types |
Domain için desteklenen DNS kayıt türlerini listeler. |
Get domain EPP Code |
Transfer için gerekli EPP/Auth kodunu getirir. |
Synchronize domain |
Domain durumunu kayıt operatörü bilgileriyle eşitler. |
Get domain lock |
Registrar/transfer kilidinin durumunu getirir. |
Update domain lock |
Registrar/transfer kilidini günceller. |
Update domain ID Protection |
Desteklenen domainlerde kimlik gizleme tercihini günceller. |
Get domain contact info |
Domainin kayıtlı iletişim bilgilerini getirir. |
Update domain contact info |
Desteklenen uzantılarda domain iletişim bilgilerini günceller. |
Get email forwarding |
Domain e-posta yönlendirme ayarlarını getirir. |
Update email forwarding |
Domain e-posta yönlendirme ayarlarını günceller. |
Update domain forwarding |
Domain web yönlendirme ayarlarını günceller. |
Get domain autorenew |
Domainin otomatik yenileme durumunu getirir. |
Enable/disable domain autorenew |
Domainin otomatik yenileme tercihini etkinleştirir veya kapatır. |
Returns the available flags |
Domain için kullanılabilen DNSSEC bayraklarını listeler. |
Returns the list of DNSSEC keys |
Domaine bağlı DNSSEC anahtarlarını listeler. |
Adds the DNSSEC key |
Domaine yeni DNSSEC anahtarı ekler. |
DELETE /domain/{id}/dnssec/{key} |
Panelde adı boş görünen etkin yöntemdir; izin verilen DNSSEC anahtarını kaldırır. |
Domain availability |
Bir alan adının kayıt için müsaitliğini sorgular. |
Available TLDs |
Satışa açık domain uzantılarını listeler. |
Additional data for TLD |
Belirli uzantının istediği ek kayıt alanlarını getirir. |
Order new domain |
Uygun domain için yeni kayıt siparişi oluşturur. |
Renew domain |
Uygun domain için yenileme siparişini başlatır. |
Domain API; portföy takibi, otomatik yenileme kontrolü, nameserver değişikliği, transfer hazırlığı ve DNSSEC yönetimi gibi tekrarlanan işleri tek panelde toplamak isteyen işletmelere önemli zaman kazandırır.
Yeni bir alan adı arıyorsanız SetCloud Domain Sorgulama sayfasından uzantı ve müsaitlik bilgilerini kontrol edebilirsiniz.
8. SSL sertifikası yöntemleri
| Yöntem | İşlev |
List SSL Certificates |
Hesapta sipariş edilmiş SSL sertifikalarını listeler. |
Certificate details |
Belirli bir SSL sertifikasının ayrıntılarını getirir. |
Download certificate |
Hazır durumdaki sertifika dosyasını indirir. |
List available certificates |
Sipariş verilebilen SSL ürünlerini listeler. |
List server software for certificates |
Sertifika başvurusunda seçilebilen sunucu yazılımlarını listeler. |
Order new certificate |
Uygun SSL ürünü için yeni sertifika siparişi oluşturur. |
Sertifika indirme yanıtının biçimi ve varsa CA Bundle bilgisi, seçilen ürüne ve güncel API dokümantasyonuna göre işlenmelidir. SSL ürünlerini SetCloud SSL Sertifikaları sayfasından inceleyebilirsiniz.
9. Hizmet yönetimi
| Yöntem | İşlev |
List services |
Müşteri hesabındaki hizmetleri listeler. |
Service details |
Seçilen hizmetin durumunu, yapılandırmasını ve izin verilen ayrıntılarını getirir. |
List service methods |
Belirli hizmet için kullanılabilir API işlemlerini listeler. |
Upgrade Options |
Hizmete uygulanabilen yükseltme seçeneklerini getirir. |
Upgrade Request |
Seçilen yükseltme için talep veya sipariş oluşturur. |
Cancel Service |
Uygun hizmet için iptal talebi gönderir. |
Service label |
Hizmete tanımlanmış etiketi gösterir. |
Change service label |
Hizmet etiketini değiştirir. |
Manual Service Renew |
Desteklenen hizmet için manuel yenileme sürecini başlatır. |
List Billing Cycle |
Hizmette kullanılabilecek faturalandırma dönemlerini listeler. |
Change Billing Cycle |
Ürün izin veriyorsa hizmetin faturalandırma dönemini değiştirir. |
Hizmet etiketleri, aynı türde çok sayıda ürünü bulunan kullanıcıların hizmetlerini proje, müşteri veya kullanım amacına göre ayırmasına yardımcı olur.
SetCloud’un Web Hosting, Kurumsal Hosting ve Reseller Hosting çözümlerini inceleyebilirsiniz.
10. Ürün, sepet ve sipariş yöntemleri
| Yöntem | İşlev |
List product categories |
Siparişe açık ürün kategorilerini listeler. |
List products in category |
Seçilen kategorideki ürünleri getirir. |
Get product configuration details |
Ürünün zorunlu ve isteğe bağlı yapılandırma alanlarını getirir. |
Order new service |
Tek bir ürün veya hizmet için sipariş oluşturur. |
Order multiple services |
Birden fazla uygun ürünü aynı sipariş akışında işler. |
Get order quote |
Sipariş gönderilmeden önce fiyat ve temel faturalandırma özetini oluşturur. |
Sipariş işlemleri ücret doğurabileceği için uygulama tarafında ürün, dönem, para birimi, domain gereksinimi ve toplam tutar kullanıcıya açıkça gösterilmelidir. Canlı siparişten önce fiyat teklifi alınması ve kullanıcı onayı kullanılması önerilir.
11. DNS hizmeti ve zon yönetimi
Domain altındaki DNS yöntemlerine ek olarak, hesabınıza bağlı bağımsız DNS hizmetleri için ayrı zon ve kayıt yönetimi yöntemleri bulunur.
| Yöntem | İşlev |
List DNS |
Müşteri hesabına bağlı DNS hizmetlerini listeler. |
Add DNS zone |
İzin verilen DNS hizmetinde yeni zon oluşturur. |
List DNS for service |
Belirli DNS hizmetinin zonlarını listeler. |
Get DNS zone |
Seçilen DNS zonunun ayrıntılarını ve kayıtlarını getirir. |
Edit DNS zone |
DNS zonunun desteklenen ayarlarını günceller. |
Remove DNS zone |
İzin verilen DNS zonunu siler. |
Add DNS Record |
Zona yeni DNS kaydı ekler. |
Edit DNS Record |
Mevcut zon kaydını günceller. |
Remove DNS Record |
Seçilen zon kaydını siler. |
A, AAAA, CNAME, MX, TXT ve SRV gibi kayıt türlerinin kullanılabilirliği ilgili hizmete ve API dokümantasyonunda dönen izinlere bağlıdır. DNS değişikliklerinde kayıt adı, TTL ve değer doğrulanmalı; silme işlemlerinde kullanıcıdan açık onay alınmalıdır.
12. Bildirimler, duyurular ve bilgi bankası
| Yöntem | İşlev |
List all portal notifications |
Müşteri panelindeki tüm erişilebilir bildirimleri listeler. |
List new portal notifications |
Yeni veya okunmamış bildirimleri getirir. |
Acknowledge notification |
Görüntülenen bildirimi onaylanmış/okunmuş olarak işaretler. |
List News |
SetCloud duyurularını listeler. |
Get news item |
Belirli bir duyurunun ayrıntılarını getirir. |
List all knowledgebase categories |
Bilgi bankası kategorilerini listeler. |
Get knowledgebase category details |
Seçilen kategorinin ayrıntılarını ve içeriklerini getirir. |
Get knowledgebase article |
Belirli bilgi bankası makalesini getirir. |
Bu yöntemler; bakım duyurularını, önemli hesap bildirimlerini ve destek içeriklerini kendi uygulamanızda göstermenizi sağlar.
13. Proxmox sanal sunucu API yöntemleri
SetCloud hesabına bağlı, API erişimine açık Proxmox tabanlı hizmetlerde sanal makine yaşam döngüsü ve ağ işlemleri ayrı yöntemlerle yönetilebilir.
Sanal makine yaşam döngüsü
| Yöntem | İşlev |
List VMs |
Hizmete bağlı sanal makineleri listeler. |
Get VM Details |
Seçilen sanal makinenin izin verilen ayrıntılarını getirir. |
Create VM |
Satın alınan kaynak sınırları içinde yeni sanal makine oluşturur. |
Destroy VM |
Seçilen sanal makineyi kalıcı olarak siler. |
Resize VM |
Uygun kaynaklar çerçevesinde sanal makinenin boyutunu değiştirir. |
Stop VM |
Sanal makineyi durdurur. |
Start VM |
Durdurulmuş sanal makineyi başlatır. |
Shutdown VM |
İşletim sistemine kontrollü kapanma isteği gönderir. |
Reboot VM |
Sanal makineyi yeniden başlatır. |
Reset VM |
Sanal makineye zorunlu sıfırlama işlemi uygular. |
Change VM hostname |
Sanal makine için desteklenen hostname bilgisini değiştirir. |
Reinstall VM |
Seçilen işletim sistemi şablonuyla yeniden kurulum başlatır. |
Destroy VM, Reset VM ve Reinstall VM veri kaybına yol açabilecek işlemlerdir. Entegrasyonda açık uyarı, ikinci onay ve mümkünse işlem günlüğü kullanılmalıdır.
IP ve ağ yönetimi
| Yöntem | İşlev |
List IPs |
Sanal makine veya hizmete atanmış IP adreslerini listeler. |
List IP Pools |
Hesap için kullanılabilir IP havuzlarını getirir. |
Allocate IPs |
İzin verilen havuzdan IP tahsisi gerçekleştirir. |
List available networks |
Sanal makineye bağlanabilecek ağları listeler. |
List VM Network Interfaces |
Sanal makinenin ağ arayüzlerini getirir. |
Get Network Interface |
Belirli ağ arayüzünün ayrıntılarını gösterir. |
Update Network Interface |
Ağ arayüzünün desteklenen ayarlarını günceller. |
Add Network Interface |
Sanal makineye yeni ağ arayüzü ekler. |
Remove Network Interface |
Seçilen ağ arayüzünü kaldırır. |
Şablon, kaynak ve yükseltme
| Yöntem | İşlev |
List OS templates |
Yeniden kurulum veya yeni VM için kullanılabilir işletim sistemi şablonlarını listeler. |
Resources |
Hizmette kullanılabilir ve tüketilmiş kaynak bilgilerini getirir. |
Upgrade Options |
Proxmox hizmeti için satın alınabilecek yükseltmeleri listeler. |
Upgrade Request |
Seçilen kaynak yükseltmesi için talep veya sipariş oluşturur. |
Proxmox yöntemlerinin görünmesi, her müşterinin her işlemi kullanabileceği anlamına gelmez. VM türü, ürün yapılandırması, satın alınan kaynaklar ve hizmete tanımlı izinler kullanılabilir işlemleri belirler.
SetCloud Hosting API güvenliği nasıl sağlanır?
SetCloud API erişimi HTTPS üzerinden yapılır. Paneldeki güncel yapı, JWT oturum akışıyla birlikte MFA doğrulama yöntemleri sunar. Altyapı desteklese bile etkin kimlik doğrulama seçeneği ve kullanılabilir route’lar SetCloud yapılandırmasına göre belirlenir.
Güvenli bir entegrasyonda şu kurallar uygulanmalıdır:
-
API bağlantıları yalnızca HTTPS üzerinden kurulmalıdır.
-
Parola ve tokenlar kaynak koduna gömülmemelidir.
-
Gizli bilgiler
.envdosyası veya güvenli secret manager içinde saklanmalıdır. -
Token süresi dolduğunda kontrollü yenileme akışı kullanılmalıdır.
-
Çıkış veya yetki iptalinde token revoke edilmelidir.
-
MFA etkin hesaplar için challenge ve verification adımları desteklenmelidir.
-
Her API hatası otomatik olarak sınırsız tekrar edilmemelidir.
-
Rate limit yanıtlarında artan bekleme süresi uygulanmalıdır.
-
Ücret doğuran veya veri silen işlemlerde kullanıcı onayı alınmalıdır.
-
Uygulama loglarında parola, Bearer token, EPP kodu veya hassas iletişim bilgisi tutulmamalıdır.
-
Her kullanıcı yalnızca ihtiyaç duyduğu yöntemleri çağırmalıdır.
API altyapısında yöntem bazlı erişim, çağrı kayıtları, route etkinleştirme/devre dışı bırakma, route alias ve istek sınırlandırma gibi yönetim özellikleri bulunur. Bu yapı, gereksiz fonksiyonların kapatılmasına ve API kullanımının denetlenmesine yardımcı olur.
SetCloud User API nasıl çalışır?
Temel JWT bağlantı akışı şöyledir:
-
Uygulama, müşteri kimlik bilgileriyle giriş isteği gönderir.
-
Hesapta MFA etkinse API bir MFA doğrulama akışı başlatır.
-
Geçerli MFA kodu doğrulandıktan sonra erişim tokeni alınır.
-
Token, sonraki çağrılarda
Authorization: Bearerbaşlığıyla gönderilir. -
Token süresi dolmadan veya dolduktan sonra desteklenen yenileme yöntemi kullanılır.
-
Oturum kapatılırken token sonlandırılır veya revoke edilir.
API temel adresi:
https://panel.setcloud.com.tr/api
Örnek giriş isteği:
curl -X POST 'https://panel.setcloud.com.tr/api/login' \
-H 'Content-Type: application/json' \
--data '{"username":"MUSTERI_KULLANICI_ADI","password":"PAROLA"}'
Token ile kullanıcı ayrıntısı sorgulama örneği:
curl 'https://panel.setcloud.com.tr/api/details' \
-H 'Authorization: Bearer JWT_TOKEN' \
-H 'Accept: application/json'
Bu komutlar yalnızca çalışma mantığını göstermek için hazırlanmıştır. Kesin parametre adları, istek gövdesi ve yanıt biçimi için müşteri panelindeki güncel dokümantasyonu kullanın. Gerçek parola veya tokeni komut geçmişine, ekran görüntüsüne ya da herkese açık bir ortama kaydetmeyin.
Etkileşimli API dokümantasyonu
SetCloud müşterileri, müşteri panelinde oturum açtıktan sonra erişimlerine açık güncel API dokümantasyonunu görüntüleyebilir. Dokümantasyonda genellikle şunlar yer alır:
-
Kullanılabilir API kategorileri ve yöntemleri,
-
Her yöntemin HTTP fiili ve route bilgisi,
-
Zorunlu ve isteğe bağlı parametreler,
-
Örnek istek ve yanıtlar,
-
cURL, PHP ve Python gibi diller için örnekler,
-
OpenAPI/Swagger çıktısı,
-
Hesap ve hizmete göre etkin yöntemler.
Kullanıcı API’si kendi kendini belgeleyen bir yapı sunduğu için entegrasyon kodunu sabit bir ekran görüntüsüne göre değil, panelde yayınlanan güncel sözleşmeye göre geliştirmek gerekir.
SetCloud Müşteri Paneline Giriş Yapın
Hosting API kullanım senaryoları
Ajanslar için domain ve hizmet paneli
Bir ajans; müşteri hesabındaki hosting paketlerini, domainleri, SSL sertifikalarını ve faturaları kendi operasyon ekranında bir araya getirebilir. Hizmet etiketleri kullanılarak her ürün ilgili proje veya müşteriye bağlanabilir.
Otomatik uygulama kurulumu
Yeni bir proje oluşturulduğunda gerekli A, CNAME, MX veya TXT kayıtları DNS API üzerinden eklenebilir. SSL sipariş durumu ve hosting hizmeti aynı iş akışından takip edilebilir.
Kurumsal fatura ve ödeme takibi
Fatura listesi, bakiye ve ödeme yöntemi bilgileri şirket içi raporlama ekranına aktarılabilir. Vadesi yaklaşan faturalar için kurum içi bildirim üretilebilir.
Destek masası entegrasyonu
SetCloud destek talepleri başka bir yardım masasında listelenebilir; talep ayrıntıları ve ekleri görüntülenebilir, yeni talep veya yanıt oluşturulabilir.
Domain portföy otomasyonu
Domain müsaitliği, TLD ek alanları, yenileme, nameserver, transfer kilidi, EPP kodu, iletişim bilgileri ve DNSSEC süreçleri tek arayüzde yönetilebilir.
Proxmox VPS yönetim paneli
Desteklenen sanal sunucu müşterileri; VM listesini ve kaynak durumunu görüntüleyebilir, sunucuyu başlatabilir, durdurabilir, yeniden başlatabilir, işletim sistemi şablonlarını listeleyebilir ve yetki verildiyse ağ arayüzlerini yönetebilir.
SetCloud Hosting API kimler için uygundur?
Yazılım geliştiriciler
Hosting, domain, DNS, SSL, fatura ve sanal sunucu işlemlerini web veya mobil uygulamalarına entegre etmek isteyen geliştiriciler için uygundur.
Dijital ajanslar
Birden fazla proje için kullanılan SetCloud hizmetlerini tek operasyon ekranından takip etmek isteyen ajanslara zaman kazandırır.
Kurumsal BT ekipleri
Hizmet envanterini, ödeme takibini, DNS değişikliklerini ve destek süreçlerini kurum içi araçlarla birleştirmeye yardımcı olur.
Domain portföyü yöneten işletmeler
Çok sayıda domainin nameserver, kayıt kilidi, EPP, yenileme ve DNSSEC süreçlerini daha düzenli yönetmelerini sağlar.
Bulut ve VPS otomasyonu geliştiren ekipler
Proxmox tabanlı desteklenen hizmetlerde VM yaşam döngüsü, IP, ağ arayüzü, işletim sistemi ve kaynak işlemlerini otomasyona bağlayabilir.
Neden SetCloud Hosting API kullanmalısınız?
-
Tekrarlanan manuel işlemleri azaltır.
-
Farklı hizmetleri ortak bir uygulamada birleştirir.
-
Standart ve denetlenebilir iş akışları kurulmasına yardımcı olur.
-
Domain, DNS, SSL, fatura, destek ve VPS işlemlerini aynı entegrasyonda toplar.
-
JSON tabanlı yanıtlarla modern yazılım dillerine uyum sağlar.
-
MFA, token yönetimi ve yöntem bazlı erişimle güvenli entegrasyon kurulmasını destekler.
-
Etkileşimli dokümantasyon, OpenAPI/Swagger çıktısı ve güncel yöntem listesi geliştirme sürecini hızlandırır.
-
İşletme büyüdükçe ölçeklenebilen otomasyonlar oluşturulmasını sağlar.
SetCloud API ile dijital operasyonlarınızı hızlandırın
SetCloud Hosting API; müşteri panelindeki izin verilen işlemleri kendi yazılımlarınıza taşıyarak daha hızlı, düzenli ve ölçeklenebilir iş akışları oluşturmanıza yardımcı olur. Fatura takibinden domain yönetimine, DNS kayıtlarından SSL sertifikalarına, destek taleplerinden Proxmox sanal sunucu işlemlerine kadar geniş bir kapsam tek entegrasyon üzerinden yönetilebilir.
SetCloud müşterisiyseniz müşteri paneline giriş yaparak hesabınıza açık yöntemleri, güncel parametreleri ve kod örneklerini inceleyebilirsiniz. Entegrasyon kapsamı veya kullanım senaryonuz hakkında desteğe ihtiyacınız varsa SetCloud ekibiyle iletişime geçin.
Müşteri Paneline Giriş Yap
SetCloud Hizmetlerini İncele
SetCloud Hosting API hakkında sıkça sorulan sorular
SetCloud Hosting API nedir?
SetCloud Hosting API, müşterilerin kendi hesaplarına bağlı fatura, destek, domain, DNS, SSL, hizmet ve desteklenen Proxmox sanal sunucu işlemlerini harici yazılımlar üzerinden yönetmesine imkân veren REST API hizmetidir.
User API ile Admin API arasındaki fark nedir?
User API, oturum açan müşterinin kendi hesabı ve kendisine atanmış hizmetlerle sınırlıdır. Admin API ise platform yöneticilerine yönelik farklı ve daha geniş bir yetki alanına sahiptir. SetCloud Hosting API müşteriye yönetici yetkisi vermez.
API’de MFA desteği var mı?
Evet. Etkin yöntemler arasında Request MFA ve Verify MFA bulunur. MFA etkin hesaplarla çalışan uygulamalar giriş akışında bu doğrulama adımlarını desteklemelidir.
API ile domain satın alabilir ve yenileyebilir miyim?
Hesabınıza ve ürün yapılandırmasına bağlı olarak domain müsaitliği sorgulanabilir, TLD bilgileri alınabilir, yeni domain siparişi veya yenileme işlemi başlatılabilir. Ücret doğuran işlemlerde kullanıcı onayı alınmalıdır.
Domain nameserver ve DNSSEC işlemleri destekleniyor mu?
Evet. Etkin yöntemler; nameserver görüntüleme/güncelleme, kayıtlı özel nameserver yönetimi, DNSSEC bayraklarını ve anahtarlarını listeleme, DNSSEC anahtarı ekleme ve kaldırma işlemlerini kapsar. Kullanılabilirlik domain uzantısına ve kayıt operatörüne bağlıdır.
API ile DNS kaydı yönetilebilir mi?
Evet. Hesabınıza bağlı ve erişim izni bulunan domain veya DNS hizmetlerinde kayıtlar listelenebilir; desteklenen türlerde kayıt ekleme, düzenleme ve silme işlemleri yapılabilir.
API üzerinden hizmet veya SSL siparişi verilebilir mi?
Evet. Ürün kategorileri ve yapılandırma alanları sorgulanabilir, tekli veya çoklu hizmet siparişi oluşturulabilir ve fiyat teklifi alınabilir. SSL ürünleri listelenebilir ve uygun sertifika için sipariş başlatılabilir.
Faturaları ve PDF belgesini API ile alabilir miyim?
Evet. Fatura listesi ve ayrıntıları görüntülenebilir; etkin Invoice PDF yöntemi üzerinden belirli faturanın PDF verisine erişilebilir.
Destek talepleri API ile yönetilebilir mi?
Evet. Talepler listelenebilir, ayrıntı ve ek dosyalar alınabilir, yeni talep açılabilir, yanıt gönderilebilir, uygun talepler yeniden açılabilir veya kapatılabilir.
Proxmox sanal sunucular API ile yönetilebilir mi?
Desteklenen Proxmox hizmetlerinde VM listeleme, oluşturma, silme, yeniden boyutlandırma, başlatma, durdurma, kapatma, yeniden başlatma, sıfırlama, hostname değiştirme ve yeniden kurma yöntemleri bulunur. IP ve ağ arayüzü yönetimi de hizmet izinlerine göre kullanılabilir.
Bir yöntem neden hesabımda çalışmıyor olabilir?
Yöntem yönetici tarafından kapatılmış olabilir, ürün ilgili fonksiyonu desteklemeyebilir, hizmet durumu uygun olmayabilir veya müşteri/iletişim kişisi gerekli yetkiye sahip olmayabilir. Önce List service methods yanıtı ve müşteri panelindeki güncel dokümantasyon kontrol edilmelidir.
API kullanım limiti var mı?
Hizmetin güvenli ve dengeli çalışması için yöntem bazlı istek sınırlandırması uygulanabilir. Entegrasyonlar HTTP durum kodlarını doğru işlemeli, gereksiz tekrar çağrılarından kaçınmalı ve rate limit durumunda artan bekleme süresi kullanmalıdır.
API dokümantasyonuna nereden ulaşabilirim?
Etkileşimli API dokümantasyonu, güvenlik yapılandırmasına bağlı olarak SetCloud müşteri paneline giriş yaptıktan sonra görüntülenir. Dokümantasyon hesabınız için etkin yöntemleri, route bilgilerini, parametreleri ve güncel kod örneklerini gösterir.
API’yi kullanmak için yazılım bilgisi gerekli mi?
Temel HTTP, REST API ve JSON bilgisi önerilir. cURL, Postman, PHP, Python, JavaScript ve REST API desteği bulunan diğer araçlarla entegrasyon geliştirilebilir. Kritik üretim entegrasyonlarında deneyimli bir geliştiriciden destek alınması tavsiye edilir.