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_idhide_routine
GET/actions/{id}
Action durumu (uzun işlemler bununla yoklanır)
database_types
GET/database_types
Veritabanı paketleri
databases
GET/databases
Veritabanları
POST/databases
Veritabanı oluştur
istek gövdesi var
GET/databases/{id}
Veritabanı detayı + bağlantı dizesi
id*
DELETE/databases/{id}
Veritabanını sil
id*
GET/databases/{id}/backups
Veritabanının yedeklerini listele
id*
POST/databases/{id}/actions/change_type
Veritabanı paketini değiştir
id*istek gövdesi var
POST/databases/{id}/actions/restore
Yedekten geri yükle
id*istek gövdesi var
GET/databases/{id}/pitr-window
Zamana geri yükleme penceresi
id*
POST/databases/{id}/actions/restore-to-time
Zamana geri yükle
id*istek gövdesi var
GET/databases/{id}/metrics
Veritabanı metrikleri
id*hours
GET/databases/{id}/slow-queries
En çok zaman harcayan sorgular
id*
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*
invoices
GET/invoices
Hesabın tüketim faturaları (ay sonu kesilir; prepaid modelde ödeme talebi değil belgedir)
GET/invoices/{id}
Tek fatura + kalem dökümü
id*
locations
GET/locations
Lokasyonlar
oauth
POST/oauth/register
Dinamik istemci kaydı (RFC 7591)
istek gövdesi var
GET/oauth/authorize
Yetkilendirme isteği (tarayıcıdan)
response_type*client_id*redirect_uri*code_challenge*code_challenge_method*statescope
POST/oauth/token
Kod ya da yenileme token'ını erişim token'ına çevirir
istek gövdesi var
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.