API referansı
API işlemlerini kullanın ve sonuçlarını yorumlayın
Mevcut uç noktaları, idempotency kurallarını, kuyruğa alınmış eylem yanıtlarını ve işlem izleme üzerindeki mevcut sınırları okuyun.
Bu sayfada
Başlamadan önce
- Geçerli bir oturum ve korumalı değişiklikler için CSRF belirteci.
- Mevcut katalogdan veya kimliği doğrulanmış API yanıtlarından alınan tanımlayıcılar.
- Her sipariş, çekim veya donanım eylemi için benzersiz bir Idempotency-Key.
Değiştirmeden önce hesabı okuyun
Hesabı, bakiyeyi ve hedef kaynağı doğrulamak için okuma uç noktalarını kullanın. GET /api/v1/me, username, balanceUsd ve oturumun csrfToken değerini döndürür. Kaynak tanımlayıcıları hesaba özeldir; başka bir ortamdan değer kopyalamak yerine geçerli hesap için döndürülen sunucu veya ağ tanımlayıcısını kullanın.
Mevcut API, tam bir eşzamansız iş platformu değil, kompakt bir hesap arayüzüdür. Başarılı yazmalardan referansları kendi kayıtlarınızda saklayın. Her siparişi listeleyecek, belirli bir kuyruğa alınmış eylemi inceleyecek veya bir çekimin en son inceleme durumunu alacak bir uç nokta yoktur.
| Uç noktayı oku | Döndürülen veriler |
|---|---|
| GET /api/v1/ledger | En yeni 100 defter girişleri, en yeni önce; sayfalama sözleşmesi yok. |
| GET /api/v1/servers | Sonlandırılmamış sunucular, durum, bölge, paidThrough, graceUntil ve autoRenew. |
| GET /api/v1/network | Atanmış adresler, önek uzunlukları, PTR değerleri ve ilgili sunucu tanımlayıcıları. |
| GET /api/health | Temel hizmet ve katalog sayıları; hesap veya fiziksel sunucu sağlığı garantisi yok. |
Eşleşen değişiklik uç noktasını kullanın
Desteklenen sunucu eylemleri yeniden başlatma, power_off, yeniden yükleme, mount_iso, kvm ve rotate_root_password'dir. Özel ISO URL'si, gömülü kimlik bilgileri olmadan genel HTTPS kullanmalıdır. Sipariş süresi haftalık veya aylıktır ve yedi veya otuz günü temsil eder. Fiyat, indirimler, fonlar ve kapasite hizmet tarafından kontrol edilir; istemci tarafından hesaplanan bir fiyatı yetkili olarak göndermeyin.
| Uç nokta | İstek alanları ve sonuç |
|---|---|
| POST /api/v1/orders | configId, regionId, osId, dönem, miktar; isteğe bağlı sshPublicKey. Sipariş kimliği ve ACCEPTED döndürür. |
| POST /api/v1/deposit-addresses | varlık. Dönüş adresi, varlık, ağ, gerekli onaylar ve mod veya ödeme-kullanılamıyor hatası döndürür. |
| POST /api/v1/withdrawals | varlık, hedef, usd. id ve PENDING_REVIEW döndürür; bakiye tutulur. |
| POST /api/v1/servers/{id}/actions | eylem; mount_iso için isoUrl. Eylem kimliği ve QUEUED döndürür. |
| PUT /api/v1/servers/{id}/ddos | mod: BASELINE veya ADVANCED. QUEUED veya UNCHANGED ve quoteRequired döndürür. |
| PUT /api/v1/network/{id}/rdns | ptr veya temizlemek için boş bir değer. Saklanan PTR değerini döndürür. |
Yeniden denemeleri bilinçli yapın
Siparişler, para çekme işlemleri, sunucu eylemleri ve DDoS istekleri Idempotency-Key gerektirir. 8–100 harf, rakam, tire veya alt çizgi kullanın ve her ayrı amaçlanan işlem için yeni bir anahtar ayırın. Belirsiz bir yanıt araştırılabilmesi için göndermeden önce orijinal anahtarı, kaynağı ve yükü koruyun.
Siparişler, aynı anahtar ve normalleştirilmiş istek için mevcut sonucu yeniden oynatabilir; değiştirilen sipariş ayrıntıları bir çakışma üretir. Sunucu eylemi yeniden oynatmaları, uyumlu olduğunda mevcut eylemi döndürür. Eylem anahtarlarını hesaptaki tüm sunucularda benzersiz tutun. Para çekme işlemleri, orijinal isteği başarı olarak döndürmek yerine zaten kaydedildiğinde bir çakışma bildirir.
POST /api/v1/servers/{serverId}/actions HTTP/1.1
Content-Type: application/json
x-csrf-token: <current-session-token>
Idempotency-Key: <unique-operation-key>
Cookie: <current-session-cookies>
{"action":"reboot"}Kabulü tamamlanmadan ayırın
Bir 202 QUEUED yanıtı, donanım talebinin kaydedildiğini doğrular. Çalışan bir KVM URL'si, yeni bir root parolası veya makinenin yeniden başlatıldığına dair kanıt içermez. Aynı şekilde, ACCEPTED bir siparişin sağlama sürecine girdiğini; PENDING_REVIEW ise operatör incelemesi bekleyen bir para çekme işlemini kaydeder. Yürütme hakkında soru sorarken döndürülen tanımlayıcıyı koruyun.
Bu sürümde eylem durumu yoklama rotası yoktur. İlgili yerlerde sunucu veya ağ verilerini yeniden okuyun ve fiziksel etkiler için operatör onayı alın. Saklanan bir PTR veya DDoS tercihi tek başına genel DNS veya canlı ağ korumasının ölçümü değildir.
İşi çoğaltmadan hatalara yanıt verin
- 400 doğrulama hatası: yeniden göndermeden önce belgelenen alanları düzeltin.
- 401 veya 403: yeniden denemeden önce oturum kimlik doğrulamasını veya CSRF doğrulamasını onarın.
- 404: kaynak tanımlayıcısının oturum açmış hesaba ait olduğunu doğrulayın.
- 409: hata kodunu inceleyin; yetersiz bakiye, tükenmiş kapasite ve idempotency çakışmaları farklı yanıtlar gerektirir.
- Para yatırmada 502 veya 503: kullanılabilir yeni adres döndürülmedi; transfer başlatmayın.
- Zaman aşımı veya okunamayan yanıt: mevcut hesap kayıtlarını kontrol edin ve orijinal istek ayrıntılarını koruyun. Körlemesine yeni bir işlem anahtarı oluşturmayın.