saatlik.cloud API

Kimlik Doğrulama

Her istek Authorization: Bearer başlığıyla yapılır. Anahtarını panelden oluştur: Ayarlar → API Anahtarı. Anahtar yalnızca oluşturulduğu anda bir kez gösterilir; veritabanında geri okunamayan özetiyle (hash) saklanır.

# Örnek
curl https://api.saatlik.cloud/v1/me \
  -H "Authorization: Bearer sc_live_XXXXXXXXXXXXXXXX"

Hız Limitleri

Limit aşımında 429 döner; Retry-After başlığı kaç saniye bekleneceğini söyler. Limitler panel ve API genelinde ortak sayılır.

Hatalar

Hatalar standart HTTP kodları ve tutarlı bir JSON gövdesiyle döner:

{
  "error": {
    "code": "insufficient_credit",
    "message": "Bakiyeniz bu işlem için yeterli değil."
  }
}

Hesap

curl https://api.saatlik.cloud/v1/me \
  -H "Authorization: Bearer sc_live_..."

{
  "account": {"client_id": 1, "name": "Ad Soyad", "email": "..."},
  "balance": 195.35,
  "currency": "TRY",
  "limits": {"create_per_day": 3, "max_total_cpu": 8, ...},
  "usage": {"servers": 2, "cpu": 4, "ram_gb": 8, ...}
}

curl "https://api.saatlik.cloud/v1/transactions?per_page=25" \
  -H "Authorization: Bearer sc_live_..."

{
  "transactions": [
    {"id": 12805, "type": "usage_minute_server", "amount": -0.0116,
     "description": "Dakikalık kullanım — HKC...", "server_id": "HKC...",
     "created_at": "2026-06-09T18:33:01+03:00"}
  ],
  "meta": {"page": 1, "per_page": 25, "total": 12166}
}

Kaynaklar

curl https://api.saatlik.cloud/v1/products \
  -H "Authorization: Bearer sc_live_..."

{
  "products": [
    {"slug": "hk-2", "name": "HK-2", "category": "saatlik-bulut-sunucu",
     "cpu": 2, "ram_gb": 4, "disk_gb": 64, "hourly_rate": 0.9028,
     "billing_mode": "both", "min_credit": 250}
  ]
}

curl https://api.saatlik.cloud/v1/locations \
  -H "Authorization: Bearer sc_live_..."

{
  "locations": [
    {"slug": "prox", "label": "Frankfurt-1", "location": "Frankfurt, Almanya",
     "country": "DE", "in_stock": true}
  ]
}

curl https://api.saatlik.cloud/v1/images \
  -H "Authorization: Bearer sc_live_..."

{
  "images": [
    {"slug": "ubuntu2404", "name": "Ubuntu 24.04", "category": "os"},
    {"slug": "wordpress", "name": "WordPress", "category": "app"}
  ]
}

Sunucular

curl https://api.saatlik.cloud/v1/servers \
  -H "Authorization: Bearer sc_live_..."

{
  "servers": [
    {"id": "HKC...", "name": "web1", "hostname": "web1.alanadi.com",
     "status": "running", "ip": "1.2.3.4", "location": "Frankfurt, Almanya",
     "cpu": 2, "ram_gb": 4, "disk_gb": 64, "billing_type": "hourly",
     "hourly_rate": 0.9028, "os": "Ubuntu 24.04", "created_at": "..."}
  ]
}

curl https://api.saatlik.cloud/v1/servers/HKC... \
  -H "Authorization: Bearer sc_live_..."

{
  "server": {"id": "HKC...", "status": "running", "ip": "1.2.3.4",
    "ip_type": "ipv4", "sata_disk_gb": 0, "suspended_at": null, ...}
}

curl -X POST https://api.saatlik.cloud/v1/servers \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: siparis-001" \
  -d '{"product":"hk-2","location":"prox","os":"ubuntu2404",
       "hostname":"web1.alanadi.com","root_password":"GucluSifre123"}'

{
  "server": {"id": "HKC...", "status": "creating", "hostname": "web1.alanadi.com", ...}
}

curl -X POST https://api.saatlik.cloud/v1/servers/HKC.../actions \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"type":"reboot"}'

{"action": "reboot", "status": "running"}

curl -X POST https://api.saatlik.cloud/v1/servers/HKC.../reinstall \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"os":"almalinux9","root_password":"YeniSifre123"}'

{"reinstall": "started", "os": "almalinux9", "hostname": "web1.alanadi.com"}

curl -X POST https://api.saatlik.cloud/v1/servers/HKC.../password \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"new_password":"YeniSifre123"}'

{"password": "changed"}

curl -X POST https://api.saatlik.cloud/v1/servers/HKC.../upgrade \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"product":"hk-3"}'

{"upgrade": "completed", "product": "hk-3", "server": {...}}

curl -X DELETE https://api.saatlik.cloud/v1/servers/HKC... \
  -H "Authorization: Bearer sc_live_..."

{"terminate": "started"}

Snapshots

curl https://api.saatlik.cloud/v1/servers/HKC.../snapshots \
  -H "Authorization: Bearer sc_live_..."

{
  "snapshots": [
    {"name": "oncesi", "created": "09.06.2026 14:22", "description": null}
  ],
  "quota": 3, "used": 1
}

curl -X POST https://api.saatlik.cloud/v1/servers/HKC.../snapshots \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"guncelleme-oncesi"}'

{"snapshot": "guncelleme-oncesi"}

curl -X POST https://api.saatlik.cloud/v1/servers/HKC.../snapshots/guncelleme-oncesi/restore \
  -H "Authorization: Bearer sc_live_..."

{"restore": "completed", "snapshot": "guncelleme-oncesi"}

curl -X DELETE https://api.saatlik.cloud/v1/servers/HKC.../snapshots/guncelleme-oncesi \
  -H "Authorization: Bearer sc_live_..."

{"deleted": "guncelleme-oncesi"}

rDNS

curl https://api.saatlik.cloud/v1/servers/HKC.../rdns \
  -H "Authorization: Bearer sc_live_..."

{"ip": "1.2.3.4", "ptr": "mail.alanadi.com"}

curl -X PUT https://api.saatlik.cloud/v1/servers/HKC.../rdns \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"ptr":"mail.alanadi.com"}'

{"ip": "1.2.3.4", "ptr": "mail.alanadi.com"}

curl -X DELETE https://api.saatlik.cloud/v1/servers/HKC.../rdns \
  -H "Authorization: Bearer sc_live_..."

{"ip": "1.2.3.4", "ptr": null}