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"}
  ]
}

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

{
  "addon_types": [
    {"slug": "snapshot", "name": "Snapshot Paketi", "billing_type": "monthly",
     "hourly_rate": null, "monthly_price": 40}
  ]
}

Sipariş

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.../addons \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"type":"snapshot","quantity":1}'

{"addon": "snapshot", "quantity": 1, "status": "ordered"}

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": {...}}

Sunucu Yönetimi

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/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 https://api.saatlik.cloud/v1/servers/HKC.../addons \
  -H "Authorization: Bearer sc_live_..."

{
  "addons": [
    {"id": 12, "type": "snapshot", "name": "Snapshot Paketi", "quantity": 1,
     "status": "active", "assigned_ip": null, "next_billing": "..."}
  ]
}

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

{"cancelled": 12}

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"}

Fiziksel Sunucu

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

{
  "configs": [
    {"config": "493b1a...", "cpu": "Intel Core i7-6700", "ram_gb": 32,
     "disk": "2×4 TB HDD", "location": "Almanya", "hourly_rate": 6.81,
     "monthly_price": 3189, "stock": 1, "min_hours": 3}
  ],
  "delivery_model": "rescue"
}

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

{
  "servers": [
    {"id": "SBS-A1B2", "status": "delivered", "cpu": "AMD Ryzen 5 3600",
     "ram_gb": 64, "disk": "2×512 GB NVMe", "location": "Almanya",
     "ip": "1.2.3.4", "billing_mode": "hourly", "hourly_rate": 6.81, ...}
  ]
}

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

{
  "server": {"id": "SBS-A1B2", "status": "delivered", "ip": "1.2.3.4",
    "rescue_user": "root", "rescue_password": "...", ...}
}

curl -X POST https://api.saatlik.cloud/v1/physical/servers \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: fiziksel-001" \
  -d '{"config":"493b1a...","hostname":"db1.alanadi.com"}'

{
  "server": {"id": "SBS-A1B2", "status": "ordering", "hostname": "db1.alanadi.com", ...}
}

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

{"terminate": "completed"}

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}