Geliştiriciler

REST API

Paneldeki her işlemin bir endpoint karşılığı var. Bir token oluşturun, JSON gönderin, JSON alın.

Temel bilgiler

Base URL: https://api.bulutera.cloud/v1
Kimlik doğrulama: Authorization: Bearer YOUR_TOKEN — token'ları panelde Developer → API Keys (Geliştirici → API Anahtarları) bölümünden oluşturun
Token'lar: Hesap başına en fazla 10, dilediğiniz zaman iptal edilebilir
İstek sınırı: Hesap başına dakikada 120 istek
Faturalandırma: API üzerinden sipariş edilen sunucular cüzdanınızdan ödenir
Header'lar: Accept: application/json ve kendi User-Agent değerinizi gönderin

Paketleri listeleyin

Sipariş verirken bir paketin id değerini kullanın.

curl https://api.bulutera.cloud/v1/plans \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "User-Agent: my-app/1.0"

Sunucu oluşturun

Root parolası 8–12 karakter olmalı; bir küçük harf, bir büyük harf, bir rakam ve ! # + $ * - karakterlerinden birini içermelidir.

curl -X POST https://api.bulutera.cloud/v1/servers \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "User-Agent: my-app/1.0" \
  -d '{"plan_id": 17, "os_id": 5, "label": "web-1", "root_password": "Str0ng#Pass"}'

Endpoint'ler

Hesap ve katalog

GET	/v1/account	Hesabınız, bakiyeniz ve bayi indiriminiz
GET	/v1/plans	Satıştaki paketler ve fiyatları
GET	/v1/os	Kurabileceğiniz işletim sistemleri

Sunucular

GET	/v1/servers	Sunucularınızı listeler
POST	/v1/servers	Sunucu oluşturur
GET	/v1/servers/{id}	Sunucu ayrıntıları
PATCH	/v1/servers/{id}	Sunucuyu yeniden adlandırır
DELETE	/v1/servers/{id}	Sunucuyu iptal eder; kullanılmayan süre cüzdana iade edilir
POST	/v1/servers/{id}/start	Başlat
POST	/v1/servers/{id}/stop	Durdur
POST	/v1/servers/{id}/restart	Yeniden başlat
POST	/v1/servers/{id}/rebuild	Başka bir sistemle yeniden kurar
POST	/v1/servers/{id}/reset-password	Yeni root parolası belirler
POST	/v1/servers/{id}/request-ip-change	IP değişikliği talep eder (İstanbul)
GET	/v1/servers/{id}/upgrade-options	Bu sunucunun yükseltilebileceği paketler
POST	/v1/servers/{id}/upgrade	Daha büyük bir pakete yükseltir
POST	/v1/servers/{id}/vnc	Tarayıcı konsolu oturumu açar

Cüzdan ve faturalar

GET	/v1/wallet	Cüzdan bakiyesi
GET	/v1/wallet/transactions	Cüzdan hareketleri
GET	/v1/invoices	Faturaları listeler
GET	/v1/invoices/{id}	Fatura ayrıntıları

Destek talepleri

GET	/v1/tickets	Destek taleplerini listeler
POST	/v1/tickets	Destek talebi açar
GET	/v1/tickets/{id}	Mesajlarıyla birlikte bir destek talebi
POST	/v1/tickets/{id}/reply	Destek talebini yanıtlar
POST	/v1/tickets/{id}/close	Destek talebini kapatır

Hatalar

401 Unauthenticated

Token yanlış veya iptal edilmiş. Developer → API Keys bölümünden yeni bir tane oluşturun.

403 ve 1010 hatası

HTTP kütüphaneniz güvenlik duvarımızın engellediği varsayılan bir User-Agent gönderiyor (Python urllib, Perl LWP). Kendi User-Agent header'ınızı ayarlayın veya requests ya da httpx kullanın.

422 Unprocessable

Bir alan geçersiz; JSON gövdesi her alanı ve nedenini listeler.

429 Too Many Requests

Dakikada 120 istek sınırını aştınız. Bekleyip yeniden deneyin.

WHMCS'ten mi satış yapıyorsunuz?

Ücretsiz modülümüz bu API'yi sizin yerinize kullanır.

WHMCS modülü