HELPER VPS

VPS API: bulut sunucuları JSON REST ile otomatikleştirin

Sunucu oluşturmadan silmeye kadar kodla yönettiğiniz bulut sunucu API'si

  • JSON REST API
  • API anahtarı (Bearer) kimlik doğrulaması
  • Dakikada 300 istek

VPS API, kontrol panelinde yaptığınız sunucu oluşturma, başlatma, durdurma ve silme gibi işlemleri HTTP istekleriyle yapmanızı sağlayan programlı bir yöntemdir. HELPER VPS bulut sunucu API'si tüm üyeler için ücretsizdir; ilk ödemenizden sonra bir API anahtarı oluşturun ve hemen bağlanın.

  • REST API

    Tüm üyeler

    Ücretsiz

    Aylık faturalandırılır

    • JSON REST
    • API anahtarı (Bearer)
    • Dakikada 300
    • Ücretsiz
    Başlayın

İstek örneklerini ve yanıt biçimini hemen görmek için API belgeleri

VPS API ile neleri otomatikleştirebilirim?

VPS API, sık sık sunucu oluşturup sildiğinizde veya birden fazla sunucuyu aynı anda yönettiğinizde en büyük faydayı sağlar. En çok kullanılan dört otomasyonu derledik.

Kontrol paneli mi, VPS API mi? Hangisi ne zaman kullanılır?

Kontrol paneli ve API aynı hesabı ve aynı sunucuları yönetir. Bir veya iki sunucuyu elle yönetirken kontrol paneli pratiktir; tekrarlanan işlerde veya çok sayıda sunucuda API daha hızlıdır.

Kontrol paneli

Ekranda tıklayarak yönetim

Kimler için

  • İlk kez sunucu oluşturuyorsanız
  • Bir iki sunucuyu kendiniz yönetirken
  • İşletim sistemi yeniden kurulumu ve SSH anahtarı ekleme
  • root parolasını yeniden görüntülemek istediğinizde

VPS API

Kodla istek göndererek yönetim

Kimler için

  • Sık sık sunucu oluşturulup silinen test ortamları
  • Dağıtım hattı ve betik otomasyonu
  • Birden fazla sunucunun durumunu aynı anda okurken
  • Kendi yönetim ekranınız veya botunuzla bağlarken

Bulut sunucu API'sine nasıl bağlanılır?

Üç adımda tamamlanır. İlk olarak ilk ödemenizi yapın ve onaylandıktan sonra API anahtarları sayfasında bir anahtar oluşturun. Ardından bu anahtarı Bearer şemasıyla her isteğin Authorization başlığına ekleyin. Son olarak, temel adres https://helpervps.com/api/v1'in ardına istediğiniz yolu ekleyerek istek gönderin ve sonuçlar JSON olarak döner.

İlk olarak GET /catalog isteğini çağırmanızı öneririz. Şu anda seçilebilen sunucu türleri ve boyutları, bölge kodları, işletim sistemi ve tek tıkla uygulama kodları ile otomatik yedekleme, ek disk ve DDoS koruması fiyatları tek seferde döner. Buradan aldığınız plan, location ve image kodlarını sunucu oluşturma isteğine aynen yazmanız yeterlidir.

Bir sunucu oluşturmak için plan, konum, görüntü ve etiket değerlerini JSON olarak POST /servers'a gönderin. Eklediğiniz bir SSH anahtarının kimliğini ve yedeklemeler, ekstra_disk_gb ve ddos_protection seçeneklerini de ekleyebilirsiniz. Seçilen dönem için ödeme önceden yapılır ve yanıt sunucu kimliği, durumu ve root şifresini içerir, bu nedenle bunları hemen güvenli bir yere kaydedin.

VPS API ile hangi işlemleri yapabilirim?

VPS API, sunucunun yaşam döngüsünü baştan sona yönetir. GET /catalog ile satış listesini okur, POST /servers ile sunucu oluşturur, GET /servers ile sunucu listenizi, GET /servers/{id} ile tek bir sunucunun bilgilerini okursunuz. Yanıtta sunucu adı, durumu, IPv4 ve IPv6 adresleri, aylık ücreti, seçilen seçenekler ve bir sonraki ödeme tarihi yer alır.

Gücü POST /servers/{id}/start, stop ve reboot istekleriyle açar, kapatır ve yeniden başlatırsınız. POST /servers/{id}/renew ödeme tarihini beklemeden şimdi bir aylık ücret ödeyerek sunucuyu hemen uzatır, DELETE /servers/{id} ise sunucuyu siler. İstek sunucunun mevcut durumuyla uyuşmazsa wrong_state koduyla bildirilir, böylece betiğinizin bir sonraki adımı belirlemesi kolaylaşır.

Hatalar, durum koduyla birlikte error değeri içeren bir JSON olarak döner. Anahtar hatalıysa unauthorized, bakiye yetersizse not_enough_balance, hesaptaki sunucu sayısı sınıra ulaştıysa limit, istek sayısı fazlaysa rate_limited gibi nedenler kodlarla ayrıldığı için programınızda her duruma göre işlem yapmak kolaydır. Tam liste ve yanıt örnekleri API belgelerinde yer alır.

VPS API ücreti ne kadar?

VPS API tüm üyeler için ücretsizdir. API ile oluşturulan sunucular ve seçenekler, kontrol panelinden oluşturulan sunucularla aynı fiyatlarla ödenir.

Rakamlarla HELPER VPS

Tek bir hesapta 40 bölge, 12 işletim sistemi ve 10 tek tıkla uygulama arasından seçim yapın ve hemen ödeyin. Aşağıdaki rakamlar güncel satış listesine göredir.

VPS API ile kullanılan otomasyon araçları

HTTP isteği gönderebilen her araç VPS API'ye bağlanır. Tek satırlık curl komutundan Python ve Node.js betiklerine, dağıtım hatlarına kadar aynı yöntemle kullanırsınız.

  • Terraform
  • Python
  • Node.js
  • GitLab CI
  • Docker

Neden HELPER VPS API?

VPS API hakkında sık sorulan sorular

VPS API bağlantısı, kimlik doğrulama ve istek sınırları hakkında yanıtlar

VPS API ücretsiz mi?

Evet, VPS API tüm üyeler için ücretsizdir. API anahtarları oluşturmak ve istek göndermek ücretsizdir ve API ile oluşturulan sunucular ve seçenekler, kontrol panelinden oluşturulanlarla aynı fiyatlarla ödenir. İlk ödemesini yapmış herhangi bir üye API anahtarları sayfasında hemen bir anahtar oluşturabilir.

API anahtarını nereden oluştururum?

İlk ödemenizi yaptıktan sonra API anahtarları sayfası (/api-key) açılır ve anahtarlarınızı burada oluşturursunuz. Anahtarı Bearer şemasıyla her isteğin Authorization başlığına ekleyin. Anahtar tüm hesabınızın kilidini açar, bu nedenle kod depolarına kaydetmeyin; ortam değişkenlerinde veya bir gizli değer deposunda saklayın.

API ile hangi işlemleri yapabilirim?

Satış listesini okuma (GET /catalog), sunucu listesini ve tek sunucu bilgilerini okuma (GET /servers, GET /servers/{id}), sunucu oluşturma (POST /servers), açma, kapatma ve yeniden başlatma (start, stop, reboot), bir ay uzatma (renew) ve silme (DELETE /servers/{id}) işlemlerini yapabilirsiniz. İstek örnekleri ve yanıt biçimi API belgelerinde yer alır.

İstek sınırı nedir?

Tek bir anahtarla dakikada 300 isteğe kadar gönderirsiniz. Sınır aşılırsa 429 durum kodu ve rate_limited hatası döner; betiğinizde kısa bir süre bekleyip yeniden göndermeyi ayarlamanız yeterlidir. Sunucu listesi kontrolü ve güç yönetimi gibi günlük otomasyonlar bu sınır içinde rahatça çalışır. İstek sayısına göre ücret alınmaz.

API ile sunucu oluşturduğumda ücret nasıl alınır?

POST /servers isteği başarılı olduğunda, seçilen faturalandırma dönemi için ödeme işlenir ve sunucu oluşturulur. Oluşturulamayan bir sunucunun ödemesi hesap bakiyenize iade edilir.

root parolasını API ile nasıl alırım?

Sunucu oluşturma isteğinin yanıtında root_password değeri bir kez gelir. Yanıtı alır almaz güvenli bir yere kaydedin. Parolayı kontrol panelinde de 7 gün boyunca yeniden görebilirsiniz; SSH anahtarı numarasını da gönderirseniz parola olmadan anahtarla hemen bağlanırsınız. Yanıttaki ipv4 değeriyle SSH bağlantısını hemen başlatabildiğiniz için dağıtım betiklerine bağlamak kolaydır.

SSH anahtarını API ile ekleyebilir miyim?

Evet, sunucu oluşturma isteğinde ssh_key_id değerine eklediğiniz SSH anahtarının numarasını yazarsanız yeni sunucuya o anahtar yerleştirilir. Anahtarı kontrol panelinin SSH anahtarları ekranında bir kez eklemeniz yeterlidir; parmak izi ssh-keygen ile aynı biçimde gösterildiği için hangi anahtar olduğunu hemen anlarsınız. Anahtar numarasını bir kez belirleyip yeniden kullanırsınız.

Hangi dil veya araçlarla kullanabilirim?

HTTP isteği gönderebildiğiniz her dil ve araçla kullanılabilir. curl ile hemen deneyebilir, Python'un requests kütüphanesi, Node.js'in fetch işlevi, GitLab CI betik adımları ve Terraform'un HTTP istek özelliğinde aynı adres ve başlıklarla çağırabilirsiniz. Yanıtların hepsi JSON olduğu için sonuçları okumak kolaydır.

Hata oluştuğunu nasıl anlarım?

Hatalar, 2xx dışındaki bir durum koduyla birlikte error değeri içeren bir JSON olarak döner. Anahtar hatalıysa unauthorized, bir değer eksikse bad_request, bakiye yetersizse not_enough_balance, istek sunucu durumuyla uyuşmuyorsa wrong_state gibi nedenler ayrıldığı için programınızda her duruma göre işlem yaparsınız.

API ile oluşturulan sunucular kontrol panelinde de görünür mü?

Evet, API ve kontrol paneli aynı hesabı ve aynı sunucuları yönetir. API ile oluşturulan sunucular kontrol paneli listesinde aynen görünür; kontrol panelinden işletim sistemini yeniden kurabilir veya parolayı görüntüleyebilirsiniz. Hesap başına 10 sunucu sınırı iki yöntem için de geçerlidir. Elle yaptığınız işleri ve kodla yaptığınız işleri birlikte kullansanız da durum ve ödeme tarihleri her zaman aynı görünür.

VPS API rehberleri

API'yi ilk kez bağlarken okumanız faydalı olacak rehberler

VPS API tüm üyeler için ücretsizdir ve ilk ödemenizi yaptıktan sonra bir API anahtarı oluşturabilirsiniz. API ile oluşturulan sunucular ve seçenekler fiyat listesiyle aynı fiyatlarla ödenir ve her faturalandırma tarihinde aynı tutarla otomatik olarak yenilenir.

İstek sınırı: API anahtarı başına dakikada 300 | Hesap başına 10 sunucu | Ödeme başarısız olursa: sunucu askıya alınır, 3 gün sonra silinir | Silinen sunucuların kalan süresi iade edilmez. İadeler hesap bakiyenize yapılır.