v1 Beta — yayında

saatlik.cloud API

Kendi yazılımından sunucu kur, yönet, sonlandır. Türkiye'nin ilk saatlik sunucu API'si — tek bir curl komutuyla dakikalar içinde sunucun hazır.

1 Temel Bilgiler

Base URLhttps://api.saatlik.cloud/v1
FormatJSON — istek ve yanıt gövdeleri (Content-Type: application/json)
Kimlik DoğrulamaAuthorization: Bearer sc_live_...
Anahtar YönetimiPanel → Ayarlar → API Anahtarı — anahtar oluşturulurken bir kez gösterilir
Yetkilerread okuma   write kurma + güç + reinstall   destroy sonlandırma (ayrıca seçilmeli)
Hız Limitleri60 istek/dk · sunucu kurma 2/saat · güç işlemi 10/saat · reinstall 1/saat (sunucu başına 30 dk arayla). Aşımda 429 + Retry-After başlığı döner.
ŞartlarAPI ile sipariş, hizmet sözleşmesinin kabulü sayılır

2 Örnek İstekler

# Sunucularını listele
curl https://api.saatlik.cloud/v1/servers \
  -H "Authorization: Bearer sc_live_XXXXXXXXXXXXXXXX"

# Yeni sunucu kur (Idempotency-Key ZORUNLU — retry'da çifte kurulumu önler)
curl -X POST https://api.saatlik.cloud/v1/servers \
  -H "Authorization: Bearer sc_live_XXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: siparis-2026-001" \
  -d '{"product":"hk-2","location":"prox","os":"ubuntu2404",
       "hostname":"web1.alanadi.com","root_password":"GucluSifre123"}'

# Sunucuyu yeniden başlat
curl -X POST https://api.saatlik.cloud/v1/servers/HKC.../actions \
  -H "Authorization: Bearer sc_live_XXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"type":"reboot"}'

3 Uç Noktalar

MetotUç NoktaAçıklamaYetki
GET/v1/meHesap, bakiye, limitler ve kullanımread
GET/v1/serversSunucu listesiread
GET/v1/servers/{id}Sunucu detayı (id = sunucu kimliği, örn. HKC...)read
GET/v1/productsPaketler ve saatlik fiyatlar (slug kurulumda kullanılır)read
GET/v1/locationsLokasyonlar ve stok durumuread
GET/v1/imagesKurulabilir sistemler: os / panel / appread
POST/v1/serversSunucu kur — gövde: product, location, os, hostname, root_password (ops: billing_type, ip_type, sata_gb). Başlık: Idempotency-Key zorunlu. Başarı: 201write
POST/v1/servers/{id}/actionsGüç işlemi — gövde: {"type":"start|stop|reboot|hard_reboot|resume"}write
POST/v1/servers/{id}/reinstallYeniden kur — gövde: os, root_password (ops: hostname). Başarı: 202write
DELETE/v1/servers/{id}Sunucuyu sonlandır (geri alınamaz). Başarı: 202destroy

4 Hata Formatı

Hatalar standart HTTP kodları (401, 403, 404, 409, 422, 429) ve tutarlı bir JSON gövdesiyle döner:

{
  "error": {
    "code": "insufficient_credit",
    "message": "Bakiyeniz bu işlem için yeterli değil."
  }
}
KodAnlamı
missing_token / invalid_token401 — Bearer başlığı yok ya da anahtar geçersiz/iptal
forbidden403 — anahtarın bu işlem için yetkisi yok
not_found404 — sunucu ya da uç nokta yok
invalid_state / already_terminated / request_in_progress409 — işlem sunucunun mevcut durumuyla çelişiyor
validation_failed / invalid_product / invalid_image / invalid_action / missing_idempotency_key422 — istek gövdesi hatalı
insufficient_credit / rejected422 — bakiye yetersiz ya da hesap limiti aşıldı
rate_limited429 — hız sınırı; Retry-After başlığındaki saniye kadar bekleyin
© 2026 saatlik.cloud — API Dökümanı Soru & geri bildirim için iletişim