API referansı
HepCloud API'si hcloud API standardıyla uyumludur. Uç adresi:
https://api.hepcloud.net/v1
Kimlik doğrulama
Panelden API Token'ları sayfasında token oluşturun ve Authorization
başlığıyla gönderin:
curl -H "Authorization: Bearer <token>" https://api.hepcloud.net/v1/servers
Token'lar proje kapsamlıdır ve salt-okuma ya da okuma-yazma yetkisiyle
oluşturulur. Salt-okuma token'ı yazma isteğinde token_readonly hatası alır.
Araçlar
hcloud komut satırı aracı ve Terraform sağlayıcısı, uç adresi değiştirilerek olduğu gibi kullanılabilir. Kurulum, ortam değişkenleri ve örnek yapılandırma: Komut satırı ve Terraform.
Tüm uçlar
Aşağıdaki uçlar API token'ıyla kullanılabilir. Hesap güvenliği (2FA, oturumlar), token yönetimi, fatura ve bakiye işlemleri yalnız panelden yapılır — sızan bir token'ın hesabı ele geçirmesini engellemek için API'ye kapalıdır.
actions
GET/actions
Proje action listesi (son aktiviteler; started azalan)
per_pageidresource_typeresource_id
GET/actions/{id}
Action durumu (uzun işlemler bununla yoklanır)
datacenters
GET/datacenters
Veri merkezleri
firewalls
GET/firewalls
Güvenlik duvarları
name
POST/firewalls
Güvenlik duvarı oluştur
istek gövdesi var
GET/firewalls/{id}
Güvenlik duvarı detayı
PUT/firewalls/{id}
Güvenlik duvarını yeniden adlandır
istek gövdesi var
DELETE/firewalls/{id}
Güvenlik duvarını sil
POST/firewalls/{id}/actions/set_rules
Kuralları değiştir (tümünü değiştirir)
istek gövdesi var
POST/firewalls/{id}/actions/apply_to_resources
Duvarı kaynaklara uygula
istek gövdesi var
POST/firewalls/{id}/actions/remove_from_resources
Duvarı kaynaklardan kaldır
istek gövdesi var
images
GET/images
İmajlar
namearchitecture
GET/images/{id}
İmaj detayı
id*
locations
GET/locations
Lokasyonlar
pricing
GET/pricing
Fiyat bilgisi (currency TRY, vat_rate 20.00, primary_ips)
primary_ips
GET/primary_ips
Primary IP'leri listele (hcloud uyumlu yüzey)
GET/primary_ips/{id}
Primary IP detayı
POST/primary_ips/{id}/actions/change_dns_ptr
rDNS (PTR) kaydını değiştir
istek gövdesi var
server_types
GET/server_types
SKU listesi (TL fiyatlarla)
name
servers
POST/servers/{id}/actions/request_console
Tarayıcı konsolu (noVNC) — tek kullanımlık, kısa ömürlü URL döner
GET/servers
Sunucuları listele
POST/servers
Sunucu oluştur
istek gövdesi var
GET/servers/{id}
Sunucu detayı
DELETE/servers/{id}
Sunucuyu sil (yumuşak silme; action döner)
GET/servers/{id}/metrics
Sunucu metrikleri (CPU, disk, ağ — zaman serisi)
type*startendstep
POST/servers/{id}/actions/rebuild
İmajdan sıfırla ve başlat (veri silinir)
istek gövdesi var
POST/servers/{id}/actions/change_type
Rescale — sunucu tipini değiştir
istek gövdesi var
POST/servers/{id}/actions/{cmd}
Güç aksiyonu
cmd*
ssh_keys
GET/ssh_keys
SSH anahtarları
name
POST/ssh_keys
SSH anahtarı ekle
istek gövdesi var
GET/ssh_keys/{id}
SSH anahtarı detayı
DELETE/ssh_keys/{id}
SSH anahtarını sil
Bu liste API sözleşmesinden otomatik üretilir — her sürümde kendiliğinden güncellenir.