Endpoint referansı

KernelHost API

Tüm endpoint'ler application/json döner. Hatalar RFC 7807 (Problem+JSON) standardını izler. Her yanıt, sunucu tarafındaki denetim kaydıyla eşleştirme için X-Request-Id başlığı taşır.

MethodPathKapsam/izinAmaç
GET/v1/healthpublicKimlik doğrulamasız sağlık kontrolü.
GET/v1/meanyKendi hesap bilgisi ve anahtar üst verisi.
GET/v1/productsread:productsHerkese açık listelenen tüm ürünlerin fiyatlarıyla listesi.
GET/v1/products/{id}read:productsYapılandırma seçenekleri dahil ürün ayrıntıları.
POST/v1/orderswrite:ordersYeni sipariş. Idempotency-Key zorunludur.
GET/v1/orders/{id}read:ordersKendi siparişinizin durumu.
GET/v1/servicesread:servicesKendi servislerinizin listesi (sayfalanmış).
GET/v1/services/{id}read:servicesKendi servisinizin ayrıntıları.
GET/v1/services/{id}/credentialsread:credentialsErişim bilgileri (ayrı kapsam/izin, denetim kayıtlı).
POST/v1/services/{id}/actionswrite:servicesServis aksiyonu: start, stop, reboot, cancel (faturalama dönemi sonunda), cancel_revoke.
GET/v1/services/{id}/metricsread:servicesSize ait bir hizmetin sunucu ölçümleri (CPU, bellek, ağ).
GET/v1/services/{id}/ddos/profilesread:ddosKullanılabilir Advanced DDoS Protection profilleri.
GET/v1/services/{id}/ddos/rulesread:ddosAtanan korumalı IP adresinin güncel kuralları.
POST/v1/services/{id}/ddos/ruleswrite:ddosBir koruma kuralı ekleyin. Idempotency-Key zorunludur.
DELETE/v1/services/{id}/ddos/rules/{rule_id}write:ddosSize ait bir kuralı silin. Idempotency-Key zorunludur.
GET/v1/services/{id}/ddos/attacksread:ddosKorumalı IP adresinde tespit edilen saldırılar (Remote DDoS Protection).
GET/v1/services/{id}/ddos/attacks/{attack_id}read:ddosTek bir saldırının ayrıntıları: trafik ve dağılımlar.
GET/v1/billing/balanceread:billingBakiye.
GET/v1/billing/invoicesread:billingFaturalarınızın listesi (sayfalanmış).
GET/v1/billing/invoices/{id}/pdfread:billingFatura PDF'i.
GET/v1/webhooksread:webhooksGeçerli webhook URL'si.
PUT/v1/webhookswrite:webhooksWebhook URL'sini ayarlama veya kaldırma.

Advanced DDoS Protection kuralları

Bu uç noktalar, hesabınıza ait bir Advanced DDoS Protection hizmeti gerektirir. Okuma için active veya suspended durumu uygundur; değişiklikler active durumunu gerektirir. API anahtarında okuma için read:ddos, değişiklikler için write:ddos yetkisini açıkça etkinleştirin. Mevcut anahtarlara otomatik olarak yeni yetki verilmez. Tünel ve beyaz liste yönetimi kullanılamaz.

Profil kataloğundan app_code seçin. port, 1 ile 65535 arasında bir tam sayı olmalıdır; icmp için atlayın veya 0 gönderin. İsteğe bağlı extra_ports nesnesi, profildeki etiketleri birebir kullanarak tam sayı portları belirtir; atlanan etiketler profilin varsayılan değerlerini kullanır. Protokolleri sunucu belirler, bu nedenle protocol göndermeyin. Bilinmeyen alanlar veya etiketler HTTP 400 döndürür.

GET /v1/services/{id}/ddos/profiles

{
  "data": [{
    "app_code": "rust",
    "name": "Rust",
    "default_port": 28015,
    "protocol": "UDP",
    "extra_ports": [
      {"name": "Query", "port": 28016, "protocol": "UDP"},
      {"name": "RCON", "port": 28016, "protocol": "TCP"},
      {"name": "RustPlus", "port": 28082, "protocol": "TCP"}
    ]
  }],
  "meta": {"service_id": 1234, "protection_ip": "192.0.2.10", "max_rules": 1000}
}

POST /v1/services/{id}/ddos/rules

{
  "app_code": "rust",
  "port": 28015,
  "extra_ports": {"Query": 28016, "RCON": 28016, "RustPlus": 28082}
}

POST, oluşturulan kuralı data içinde HTTP 201 ile döndürür. GET, kuralları ve service_id, protection_ip, max_rules alanlarını içeren meta nesnesini döndürür. DELETE boş gövde kullanır ve aşağıdaki gibi HTTP 200 döndürür. Hem POST hem de DELETE için Idempotency-Key zorunludur.

GET /v1/services/{id}/ddos/rules

{
  "data": [{
    "id": "example-rule-id",
    "app_code": "rust",
    "port": 28015,
    "protocol": "UDP",
    "extra_ports": [
      {"name": "Query", "port": 28016, "protocol": "UDP"},
      {"name": "RCON", "port": 28016, "protocol": "TCP"},
      {"name": "RustPlus", "port": 28082, "protocol": "TCP"}
    ]
  }],
  "meta": {"service_id": 1234, "protection_ip": "192.0.2.10", "max_rules": 1000}
}

DELETE /v1/services/{id}/ddos/rules/{rule_id}

{"data": {"id": "example-rule-id", "deleted": true}}

Panel ve API sabit UTC aralıklarını paylaşır: hesap başına dakikada 10 yazma girişimi, korumalı IP başına dakikada 5 ve hesap başına UTC gününde 200. Kabul edilen geçersiz veya başarısız girişimler sayılır; başarılı idempotent tekrarlar sayılmaz. DDoS API okuma istekleri hesap başına dakikada 30 isteklik ortak sınıra tabidir. Korumalı IP başına en fazla 1000 kural.

HTTP 404: bilinmeyen veya başkasına ait hizmet ya da başkasına ait, bulunamayan veya sistem kuralı. HTTP 409: Advanced DDoS Protection hizmeti değil (not_supported_for_product), etkin olmayan hizmet, port çakışması veya eşzamanlı değişiklik. HTTP 429: sınıra ulaşıldı, Retry-After değerine uyun. HTTP 502: koruma hizmeti isteği tamamlayamadı. Sistem kuralı block gizlidir ve silinemez. HTTP 503: istek sınırı denetimi geçici olarak kullanılamıyor, Retry-After değerine uyun.

DDoS saldırı raporları

Bu uç noktalar, hesabınıza ait ve active veya suspended durumundaki bir Remote DDoS Protection hizmeti ile açıkça etkinleştirilmesi gereken read:ddos yetkisini gerektirir. Liste, hizmetin korumalı IP adresinde tespit edilen DDoS saldırılarını en yeniden başlayarak gösterir.

Sorgu parametreleri: from ve to, tarih (YYYY-MM-DD) veya saat dilimi içeren ISO 8601 tarih ve saat biçiminde (varsayılan: son 30 gün), limit 1 ile 100 arasında (varsayılan 25) ve offset 0 ile 9999 arasında (varsayılan 0). Zaman aralığı hiçbir zaman 90 günden daha geriye ve korumalı IP adresinin bu hizmete atandığı andan öncesine uzanmaz; meta.from ve meta.to gerçekte kullanılan aralığı gösterir.

GET /v1/services/{id}/ddos/attacks?from=2026-10-10

{
  "data": [{
    "id": "3f6c1a2e-9b47-4d8a-b5e2-7c0d9e4a1f63",
    "type": "ddos_attack",
    "started_at": "2026-11-07T18:34:06Z",
    "ended_at": null,
    "detected_bps": 20938227712,
    "detected_pps": 1998848,
    "source_ip_count": 341,
    "target_ip": "203.0.113.111",
    "details_available": true
  }],
  "paging": {"limit": 25, "offset": 0, "total": 1, "truncated": false},
  "meta": {"service_id": 5678, "protected_ip": "203.0.113.111", "from": "2026-10-10T00:00:00Z", "to": "2026-11-09T11:10:16Z", "retention_days": 90}
}

Her saldırı şu alanları içerir: id (UUID), type (ddos_attack veya hedef IP geçici olarak null route ile engellendiyse blackhole), started_at, ended_at (null olabilir), detected_bps, detected_pps, source_ip_count, target_ip ve details_available. detected_bps ve detected_pps, tespit anındaki hızı verir; filtreleme o sırada zaten başlamış olduğundan bu değerler ayrıntılardaki tepe değerin altında kalabilir. paging alanı limit, offset, total ve truncated (aralıkta 500 saldırıdan fazlası varsa true) bilgilerini, meta alanı ise service_id, protected_ip, from, to ve retention_days (90) bilgilerini içerir. Listeler 60 saniye önbellekte tutulur.

GET /v1/services/{id}/ddos/attacks/{attack_id}

{
  "data": {
    "id": "3f6c1a2e-9b47-4d8a-b5e2-7c0d9e4a1f63",
    "type": "ddos_attack",
    "started_at": "2026-11-07T18:34:06Z",
    "ended_at": null,
    "detected_bps": 20938227712,
    "detected_pps": 1998848,
    "source_ip_count": 341,
    "target_ip": "203.0.113.111",
    "details_available": true,
    "peak_bps": 20938227712,
    "peak_pps": 1998848,
    "total_bytes": 104809201664,
    "total_packets": 81887232,
    "interval_seconds": 1,
    "traffic": [{"time": "2026-11-07T18:34:06Z", "bps": 20938227712, "pps": 1998848}],
    "protocols": [{"protocol": "UDP", "avg_bps": 695618765, "avg_pps": 65645, "bytes": 104342814720, "packets": 78774272, "bps_percent": 99.56, "pps_percent": 96.2}],
    "destination_ports": [{"port": 58675, "protocol": "UDP", "avg_bps": 695556506, "avg_pps": 65481, "bps_percent": 99.55, "pps_percent": 95.96}],
    "source_ports": [{"port": 53, "protocol": "UDP", "avg_bps": 41896312, "avg_pps": 3511, "bps_percent": 5.996, "pps_percent": 5.15}],
    "source_countries": [{"country": "MX", "avg_bps": 96051528, "avg_pps": 8656}],
    "source_ips": [{"ip": "198.51.100.7", "avg_bps": 46162248, "avg_pps": 4151, "bps_percent": 6.61, "pps_percent": 6.08}],
    "packet_sizes": [{"range": "1400-1499", "avg_bps": 374806938, "percent": 54.076}]
  },
  "meta": {"service_id": 5678, "cached": false}
}

Ayrıntılar, listedeki tüm alanlara ek olarak peak_bps, peak_pps, total_bytes, total_packets ve interval_seconds alanlarını içerir. traffic, gelen saldırı trafiğini filtreleme ağının gördüğü şekliyle aralık başına ({time, bps, pps}) listeler; kapsam, tespitten yaklaşık 10 dakika önceden yaklaşık 10 dakika sonrasına kadardır. protocols, destination_ports, source_ports, source_countries, source_ips ve packet_sizes dağılımları genellikle en büyük 5 kaydı içerir: avg_bps ve avg_pps ölçüm penceresi boyunca ortalamalardır, bps_percent ve pps_percent ise paylardır. protocols ayrıca bytes ve packets, packet_sizes ise range, avg_bps ve percent alanlarını içerir. Ayrıntılar en fazla 15 dakika önbellekte tutulur.

HTTP 400 validation_failed: geçersiz değer veya bilinmeyen sorgu parametresi. HTTP 404: bilinmeyen veya başkasına ait hizmet, bilinmeyen saldırı kimliği ya da başka bir IP adresine yönelik saldırı. HTTP 409 not_supported_for_product: hizmet bir Remote DDoS Protection hizmeti değil (örneğin Advanced DDoS Protection veya bir sunucu). HTTP 409 service_not_active: hizmet ne active ne de suspended durumunda. HTTP 409 protection_not_ready: koruma hâlâ kuruluyor.

Sunucu ölçümleri

Bu uç nokta, hesabınıza ait etkin bir hizmet ve read:services yetkisi gerektirir. Edge Unlimited Traffic VPS sunucuları CPU, bellek ve gelen ile giden ağ trafiği verilerini (bit/s ve paket/s), ayrıca günlük ve ay başından bu yana giden trafiği sağlar. Avrupa, Almanya, Fransa, Kanada Doğu, Birleşik Krallık ve Polonya konumlarındaki standart Unlimited Traffic VPS sunucuları yalnızca gelen ve giden ağ trafiğini bit/s cinsinden sağlar.

Sorgu parametresi range: 1h, 6h, 24h, 7d veya 14d (varsayılan 1h). Noktalar arasındaki aralık süreye bağlıdır: Edge Unlimited Traffic VPS için yaklaşık 15 saniye (1h), 20 saniye (6h), 2 dakika (24h), 10 dakika (7d) ve 20 dakika (14d); standart Unlimited Traffic VPS için 24h süresine kadar 5 dakika, 7d için 30 dakika ve 14d için 2 saat. step_seconds yanıttaki aralığı gösterir.

GET /v1/services/{id}/metrics?range=24h

{
  "data": {
    "service_id": 1234,
    "range": "24h",
    "step_seconds": 120,
    "available": ["cpu_percent", "memory_percent", "network_in_bps", "network_out_bps", "network_in_pps", "network_out_pps"],
    "summary": {
      "cpu_percent": {"avg": 3.1, "max": 41.7, "last": 2.9},
      "network_in_bps": {"avg": 64012.5, "max": 912345.0, "last": 60026.2}
    },
    "points": [
      {"time": "2026-11-08T11:12:00Z", "cpu_percent": 3.254, "memory_percent": 43.001, "network_in_bps": 68515.425, "network_out_bps": 650.767, "network_in_pps": 119.992, "network_out_pps": 0.775},
      {"time": "2026-11-08T11:14:00Z", "cpu_percent": 3.118, "memory_percent": 43.004, "network_in_bps": 66120.871, "network_out_bps": 702.134, "network_in_pps": 115.317, "network_out_pps": 0.825}
    ],
    "traffic": {
      "month_to_date_out_bytes": 111844510,
      "daily": [{"date": "2026-11-09", "out_bytes": 10485760, "final": false}],
      "as_of": "2026-11-09T11:00:01Z",
      "unit": "bytes",
      "direction": "outbound"
    }
  },
  "meta": {"generated_at": "2026-11-09T11:12:30Z", "cached": false, "measured_at": "server_network_interface"}
}

Değerler sunucunun ağ arayüzünde ölçülür ve böylece sunucuya gerçekten ulaşan trafiği gösterir. Bellek değerleri için sunucu içinde guest agent gerekir. Ölçülemeyen değerler null olur; available, ölçülmüş değeri bulunan metrikleri listeler, summary ise her biri için avg, max ve last değerlerini verir. traffic, giden trafiği gün başına ve ay başından bu yana bayt cinsinden içerir (bir gün tamamlandığında final true olur) ve trafik sayacı olmayan ürünlerde null olur. Yanıtlar 30 saniye (1h) ile 10 dakika (14d) arasında önbellekte tutulur; meta.cached yanıtın önbellekten gelip gelmediğini gösterir.

HTTP 400 validation_failed: farklı bir range değeri veya bilinmeyen sorgu parametresi. HTTP 404: bilinmeyen veya başkasına ait hizmet. HTTP 409 not_supported_for_product: bu hizmet için ölçüm yok (diğer ürünler ve konumlar). HTTP 409 service_not_active: hizmet etkin değil.

Sunucu ölçümleri ve saldırı raporları için genel hız sınırları geçerlidir. Buna ek olarak, önbellekten yanıtlanamayan veri çekme istekleri bu üç uç nokta için toplamda hesap başına dakikada 20 ile sınırlıdır; bu sınır aşılırsa Retry-After başlığıyla birlikte HTTP 429 alırsınız. HTTP 502 monitoring_unavailable veya reports_unavailable: veri kaynağına geçici olarak ulaşılamıyor, daha sonra yeniden deneyin. HTTP 503 temporarily_unavailable ve Retry-After: paralel bir istek aynı verileri şu anda hazırlıyor.

API üzerinden sunulmayanlar: Advanced DDoS Protection ve Edge Unlimited Traffic VPS gibi sunucular için saldırı raporları; korumalı IP başına temiz veya düşürülen trafik istatistikleri; standart Unlimited Traffic VPS için CPU ve bellek değerleri; webhook teslimi ve CSV dışa aktarımı.

İdempotenlik

POST /v1/orders ve POST /v1/services/{id}/actions bir Idempotency-Key başlığı gerektirir ([A-Za-z0-9_.-] kümesinden 1 ile 80 arası karakter). Bu anahtar metoda, yola ve gövdeye bağlıdır. Aynı isteği aynı anahtarla bir saat içinde tekrarlarsanız saklanan yanıtı alırsınız; bu sürenin ardından reason replay_stale içeren bir 410 yanıtı döner ve yeni bir anahtar göndermeniz gerekir. Aynı anahtar farklı bir gövdeyle veya başka bir endpoint üzerinde kullanılırsa 409 idempotency_conflict ile reddedilir.

Hız sınırları

Varsayılan sınırlar: anahtar başına dakikada 60 istek (20 isteklik burst toleransıyla) ve günde 5.000 istek, tüm anahtarlar genelinde hesap başına dakikada 120 istek ve kaynak IP başına dakikada 600 istek. Bir sınır aşıldığında Retry-After başlığıyla birlikte HTTP 429 alırsınız. X-RateLimit-Remaining ve X-RateLimit-Reset yanıt başlıkları, anahtar sınırının güncel durumunu gösterir.