MÜŞTERİ API'Sİ · V1 BETA
VPS ve Dedicated Sunucular için
REST API
Sunucularınızı koddan yönetin: saatlik VPS sipariş edip silin, güç işlemleri ve yeniden kurulumlar çalıştırın, kendi imajlarınızı alıp dağıtın ve faturaları bakiyeden ödeyin.
X-ZoneServers Müşteri API'si (v1, herkese açık beta), HTTPS üzerinden 92 işlem sunar; OpenAPI 3.0 spesifikasyonu, kapsamı sınırlandırılmış API anahtarları ve anahtar başına saatte varsayılan 1.000 istek sınırıyla gelir. Her hesaba ek ücret olmadan dahildir.
92 API işlemi1.000 istek/saat, anahtar başına
İlk çağrınız
Müşteri panelinde Profile → API Keys bölümünden bir anahtar oluşturun, ardından API'ye kim olduğunuzu sorun.
curl https://my.x-zoneservers.com/api/v1/ \
-H "Authorization: Bearer $XZ_API_KEY"
{ "success": true,
"data": {
"version": "1",
"key": { "scopes": ["read", "services"] },
"rate_limit": { "limit": 1000, "remaining": 999 }
} }01Özellikler
Otomatikleştirebilecekleriniz
API, siparişten faturaya kadar bir sunucunun tüm yaşam döngüsünü müşteri paneliyle aynı yetkilerle kapsar.
Dağıtım ve Silme
Saatlik veya aylık faturalandırmayla bir VPS sipariş edin, ilk açılış için cloud-init user-data ve SSH anahtarlarını iletin, iş bittiğinde de silin. Saatlik faturalandırma, sunucu ortadan kalktığı anda durur.
Güç, Yeniden Kurulum ve İstatistikler
VPS'inizi başlatın, durdurun, yeniden başlatın ve yeniden kurun; root parolalarını sıfırlayın ve izleme script'lerinizden kullanım ve trafik istatistiklerini okuyun.
Özel İmajlar
Bir VPS'in imajını alın (hesap başına en fazla 3) ya da kendi qcow2 veya raw imajınızı kaydedin (SHA-256 ile doğrulanır) ve ondan yeni sunucular dağıtın.
Faturalandırma ve Kullanım
Kredi bakiyenizi ve bu ayın saatlik ücretlerini okuyun, faturaları ve proforma faturaları listeleyin ve bunları bakiyeden ödeyin — maliyet panoları ve bütçe uyarıları için kullanışlıdır.
Eklentiler ve Yükseltmeler
Mevcut bir hizmet için ek IP adresleri gibi eklentiler satın alın ya da paneli açmadan hizmeti daha büyük bir plana taşıyın.
Projeler ve Kapsamı Sınırlı Anahtarlar
Sunucuları projeler halinde gruplayın ve tek bir projeye bağlı anahtarlar oluşturun; böylece bir staging anahtarı üretim ortamını asla göremez ve ona dokunamaz.
02Nasıl çalışır
Örnek: Tek Bir CI İşi için Saatlik VPS
Temiz bir build makinesi oluşturun, pipeline'ı çalıştırın, silin — ve var olduğu saatlerin ücretini ödeyin.
Saatlik hizmetler faturalandırılmak yerine hesap bakiyenizden ücretlendirilir; bu yüzden hesapta bakiye bulundurun. Her siparişle birlikte bir Idempotency-Key başlığı gönderin: böylece zaman aşımına uğrayan bir istek, ikinci bir sunucu oluşturmadan yeniden denenebilir.
1. Bir plan seçin: ürünleri saatlik ve aylık fiyatlarıyla listeleyin.
curl https://my.x-zoneservers.com/api/v1/products \
-H "Authorization: Bearer $XZ_API_KEY"2. İlk açılış script'i ve SSH anahtarınızla saatlik faturalandırmada sipariş verin.
curl -X POST https://my.x-zoneservers.com/api/v1/orders \
-H "Authorization: Bearer $XZ_API_KEY" \
-H "Idempotency-Key: ci-run-4812" \
-H "Content-Type: application/json" \
-d '{"productId": "<plan-id>", "billingCycle": "hourly",
"hostname": "ci-4812.example.com", "location": "<location>",
"configOptions": {"os_image_id": "<image-id>",
"ssh_keys": ["ssh-ed25519 AAAA... ci@runner"],
"user_data": "#!/bin/sh\n/opt/ci/run-pipeline.sh"}}'3. İş bittiğinde sunucuyu silin. Faturalandırma anında durur.
curl -X DELETE https://my.x-zoneservers.com/api/v1/vps/<vps-id> \
-H "Authorization: Bearer $XZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"immediate": true}'03API
Script'ler ve Yapay Zeka Ajanları için Tasarlandı
Düğmelere bir insan değil de bir program bastığında, öngörülebilir davranış uç nokta sayısından daha önemlidir.
Kapsamı sınırlı anahtarlar
Her anahtar yalnızca verdiğiniz kapsamları taşır — read, services, orders, billing, destructive — ve isteğe bağlı olarak bir IP izin listesi ile son kullanma tarihi alabilir.
Yayımlanmış istek sınırları
Varsayılan olarak anahtar başına saatte 1.000 istek; sınır durumu X-RateLimit başlıklarında bildirilir ve güç ile yeniden kurulum işlemlerinde sunucu başına kısa bekleme süreleri uygulanır.
Güvenli yeniden denemeler
Siparişler bir Idempotency-Key kabul eder ve her ret, makine tarafından okunabilir bir hata kodu döndürür; böylece otomasyon, yeniden denenebilir bir hatayı gerçek bir hatadan ayırt edebilir.
Makine tarafından okunabilir dokümantasyon
İstemci üreticileri için bir OpenAPI 3.0 spesifikasyonu ve kodlama asistanlarının ve yapay zeka ajanlarının doğrudan okuyabileceği sade Markdown biçiminde bir kılavuz.
04İlgili
Kendi Müşterilerinize Sunucu mu Satıyorsunuz?
Bu Müşteri API'si kendi hesabınızı otomatikleştirir. Kendi markanızla yeniden satış yapmak için bayilik programına katılın ve bunun yerine Bayi API'sini kullanın: hacim kademeli toptan fiyatlar, HMAC imzalı istekler, webhook'lar, müşteriye bağlı anahtarlar ve müşterilerinizin bizde hesabı olmadan açabildiği konsol bağlantıları.
05Sorular
API SSS
X-ZoneServers otomasyonu hakkında sık sorulan sorular.
X-ZoneServers'ın bir API'si var mı?
Evet. Müşteri API'si (v1), https://my.x-zoneservers.com/api/v1 adresinde HTTPS üzerinden çalışan bir REST API'dir; VPS, dedicated sunucular, siparişler, eklentiler, yükseltmeler, faturalar, SSH anahtarları ve özel imajları kapsayan 92 işlem sunar. Herkese açık beta aşamasındadır: üzerine geliştirme yapacak kadar kararlıdır, ancak uç noktalar ve yanıt yapıları hâlâ değişebilir.
API erişimi ücretsiz mi?
Evet. API erişimi her hesaba ek ücret olmadan dahildir; yalnızca sipariş ettiğiniz sunucular ve eklentiler için, web sitesi ve müşteri panelindeki fiyatların aynısıyla ödeme yaparsınız.
API üzerinden saatlik VPS oluşturup silebilir miyim?
Evet. Faturalandırma döngüsü saatlik olarak ayarlanmış bir sipariş verin; isterseniz cloud-init user-data ve SSH anahtarları da ekleyin, ardından artık ihtiyacınız kalmadığında VPS'i silin. Saatlik hizmetler hesap bakiyesinden ücretlendirilir ve silindikleri anda faturalandırma durur.
API dedicated sunucularla çalışır mı?
Kısmen. Dedicated sunucular için API; sipariş, eklentiler, faturalar ve hizmet ayrıntılarını kapsar. Güç kontrolü, işletim sistemi yeniden kurulumu ve parola sıfırlama, dedicated sunucular için ne API üzerinden ne de müşteri panelinden kullanılabilir.
Kimlik doğrulamayı nasıl yaparım?
Müşteri panelinde Profile → API Keys bölümünden bir API anahtarı oluşturun ve bunu Bearer token olarak gönderin. Kapsamlarını oluştururken seçin; isterseniz anahtarı belirli IP adresleriyle sınırlandırın veya bir son kullanma tarihi verin. Anahtarlar yalnızca bir kez gösterilir ve panelden istediğiniz zaman iptal edilebilir.
OpenAPI veya Swagger spesifikasyonu var mı?
Evet. Tam OpenAPI 3.0 spesifikasyonu, işlenmiş dokümantasyonun ve Markdown biçimindeki kullanım kılavuzunun yanında https://my.x-zoneservers.com/api/v1/openapi.json adresinde yayımlanır.
Başlayın
İlk API Anahtarınızı Oluşturun
Müşteri paneline giriş yapın, Profile → API Keys bölümünü açın ve bir dakikadan kısa sürede ilk çağrınızı yapın. API ile ilgili sorular doğrudan platformu geliştiren kişilere gider.