Végpont-referencia

KernelHost API

Minden végpont application/json választ ad. A hibák az RFC 7807 (Problem+JSON) szabványt követik. Minden válasz X-Request-Id fejlécet tartalmaz a szerveroldali audit-naplóval való összevetéshez.

MethodPathJogosultságCél
GET/v1/healthpublicHitelesítés nélküli állapot-ellenőrzés.
GET/v1/meanySaját fiókinformáció és kulcs metaadatok.
GET/v1/productsread:productsMinden nyilvánosan listázott termék listája árakkal.
GET/v1/products/{id}read:productsTermékadatok, beleértve a konfigurációs opciókat.
POST/v1/orderswrite:ordersMegrendelés leadása. Idempotency-Key kötelező.
GET/v1/orders/{id}read:ordersSaját megrendelés állapota.
GET/v1/servicesread:servicesSaját szolgáltatások listája (lapozott).
GET/v1/services/{id}read:servicesSaját szolgáltatás részletei.
GET/v1/services/{id}/credentialsread:credentialsSzolgáltatási hozzáférési adatok (külön jogosultság, audit-naplózott).
POST/v1/services/{id}/actionswrite:servicesSzolgáltatási művelet: start, stop, reboot, cancel (a számlázási időszak végére), cancel_revoke.
GET/v1/services/{id}/metricsread:servicesEgy saját szolgáltatás szervermérései (CPU, memória, hálózat).
GET/v1/services/{id}/ddos/profilesread:ddosElérhető Advanced DDoS Protection profilok.
GET/v1/services/{id}/ddos/rulesread:ddosA hozzárendelt védett IP-cím aktuális szabályai.
POST/v1/services/{id}/ddos/ruleswrite:ddosEgy védelmi szabály hozzáadása. Idempotency-Key szükséges.
DELETE/v1/services/{id}/ddos/rules/{rule_id}write:ddosEgy saját szabály törlése. Idempotency-Key szükséges.
GET/v1/services/{id}/ddos/attacksread:ddosA védett IP-címen észlelt támadások (Remote DDoS Protection).
GET/v1/services/{id}/ddos/attacks/{attack_id}read:ddosEgy támadás részletei: forgalom és bontások.
GET/v1/billing/balanceread:billingEgyenleg.
GET/v1/billing/invoicesread:billingSaját számlák listája (lapozott).
GET/v1/billing/invoices/{id}/pdfread:billingSzámla PDF.
GET/v1/webhooksread:webhooksAktuális webhook URL.
PUT/v1/webhookswrite:webhooksWebhook URL beállítása vagy törlése.

Advanced DDoS Protection szabályok

Ezek a végpontok a saját fiókjához tartozó Advanced DDoS Protection szolgáltatást igényelnek. Olvasni active vagy suspended állapotban lehet; módosítani csak active állapotban. Az API-kulcson külön engedélyezze a read:ddos jogosultságot az olvasáshoz és a write:ddos jogosultságot a módosításokhoz. A meglévő kulcsok nem kapnak automatikusan új jogosultságokat. Az alagutak és az engedélyezési lista kezelése nem érhető el.

Válassza ki az app_code értékét a profilkatalógusból. A port 1 és 65535 közötti egész szám; icmp esetén hagyja el vagy küldjön 0-t. Az opcionális extra_ports objektum a profil pontos címkéihez egész portszámokat rendel; a kihagyott címkék a profil alapértékeit használják. A protokollokat a szerver határozza meg, ezért ne küldjön protocol mezőt. Ismeretlen mező vagy címke esetén HTTP 400 a válasz.

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

A POST HTTP 201 választ ad a létrehozott szabállyal a data mezőben. A GET a szabályokat és a service_id, protection_ip, max_rules mezőket tartalmazó meta objektumot adja vissza. A DELETE üres törzset vár, és az alábbi HTTP 200 választ adja. A POST és a DELETE is Idempotency-Key fejlécet igényel.

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

A panel és az API közös, rögzített UTC-időablakokat használ: fiókonként percenként 10 írási kísérlet, védett IP-címenként percenként 5, fiókonként UTC-naponként 200. A beengedett érvénytelen vagy sikertelen kísérletek beleszámítanak, a sikeres idempotens ismétlések nem. A DDoS API olvasási végpontjai közösen fiókonként percenként 30 kérést engednek. Védett IP-címenként legfeljebb 1000 szabály.

HTTP 404: ismeretlen vagy idegen szolgáltatás, illetve idegen, hiányzó vagy rendszerszabály. HTTP 409: nem Advanced DDoS Protection szolgáltatás (not_supported_for_product), inaktív szolgáltatás, portütközés vagy egyidejű módosítás. HTTP 429: elért korlát, vegye figyelembe a Retry-After fejlécet. HTTP 502: a védelmi szolgáltatás nem tudta befejezni a kérést. A block rendszerszabály rejtett és nem törölhető. HTTP 503: a kérések korlátainak ellenőrzése átmenetileg nem elérhető, vegye figyelembe a Retry-After fejlécet.

DDoS-támadási jelentések

Ezek a végpontok a saját fiókjához tartozó, active vagy suspended állapotú Remote DDoS Protection szolgáltatást, valamint a külön engedélyezendő read:ddos jogosultságot igénylik. A lista a szolgáltatás védett IP-címén észlelt DDoS-támadásokat mutatja, a legújabbal kezdve.

Lekérdezési paraméterek: from és to dátumként (YYYY-MM-DD) vagy időzónát tartalmazó ISO 8601 dátum-időként (alapértelmezés: az elmúlt 30 nap), limit 1 és 100 között (alapértelmezés 25) és offset 0 és 9999 között (alapértelmezés 0). Az időablak legfeljebb 90 napra nyúlik vissza, és soha nem korábbra, mint amikor a védett IP-címet ehhez a szolgáltatáshoz rendelték; a meta.from és a meta.to a ténylegesen használt időablakot mutatja.

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

Minden támadás tartalmazza a következő mezőket: id (UUID), type (ddos_attack, illetve blackhole, ha a cél IP-címet ideiglenesen null route-tal letiltották), started_at, ended_at (lehet null), detected_bps, detected_pps, source_ip_count, target_ip és details_available. A detected_bps és a detected_pps az észlelés pillanatában mért értéket adja meg; a szűrés ekkor már elindult, ezért ezek alacsonyabbak lehetnek a részletekben látható csúcsértéknél. A paging a limit, offset, total és truncated mezőket tartalmazza (a truncated értéke true, ha az időablakban több mint 500 támadás van), a meta pedig a service_id, protected_ip, from, to és retention_days (90) mezőket. A listákat 60 másodpercig gyorsítótárazzuk.

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

A részletek a lista összes mezőjét tartalmazzák, továbbá a peak_bps, peak_pps, total_bytes, total_packets és interval_seconds mezőket. A traffic a bejövő támadási forgalmat sorolja fel intervallumonként ({time, bps, pps}) úgy, ahogyan a szűrőhálózat látta, nagyjából 10 perccel az észlelés előttől 10 perccel utánig. A protocols, destination_ports, source_ports, source_countries, source_ips és packet_sizes bontások általában az 5 legnagyobb tételt tartalmazzák: az avg_bps és az avg_pps a mérési ablakra vett átlag, a bps_percent és a pps_percent részarány. A protocols ezen felül bytes és packets mezőt is tartalmaz, a packet_sizes pedig range, avg_bps és percent mezőt. A részleteket legfeljebb 15 percig gyorsítótárazzuk.

HTTP 400 validation_failed: érvénytelen érték vagy ismeretlen lekérdezési paraméter. HTTP 404: ismeretlen vagy idegen szolgáltatás, ismeretlen támadásazonosító vagy más IP-címet érintő támadás. HTTP 409 not_supported_for_product: nem Remote DDoS Protection szolgáltatás (például Advanced DDoS Protection vagy szerver). HTTP 409 service_not_active: a szolgáltatás sem active, sem suspended állapotban nincs. HTTP 409 protection_not_ready: a védelem beállítása még folyamatban van.

Szervermérések

Ez a végpont a saját fiókjához tartozó aktív szolgáltatást és a read:services jogosultságot igényli. Az Edge Unlimited Traffic VPS szerverek CPU-, memória- és bejövő, illetve kimenő hálózati adatokat szolgáltatnak (bit/s és csomag/s), továbbá a kimenő forgalmat naponként és a hónap elejétől. A hagyományos Unlimited Traffic VPS szerverek az Európa, Németország, Franciaország, Kelet-Kanada, Egyesült Királyság és Lengyelország helyszíneken csak a bejövő és kimenő hálózati forgalmat adják meg bit/s-ban.

Lekérdezési paraméter range: 1h, 6h, 24h, 7d vagy 14d (alapértelmezés 1h). A mérési pontok közötti távolság az időtartamtól függ: Edge Unlimited Traffic VPS esetén nagyjából 15 másodperc (1h), 20 másodperc (6h), 2 perc (24h), 10 perc (7d) és 20 perc (14d); hagyományos Unlimited Traffic VPS esetén 24h-ig 5 perc, 7d esetén 30 perc, 14d esetén 2 óra. A step_seconds a válaszban alkalmazott távolságot mutatja.

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

Az értékeket a szerver hálózati interfészén mérjük, így azt a forgalmat mutatják, amely ténylegesen elérte a szervert. A memóriaadatokhoz a szerveren futó guest agent szükséges. A nem mérhető értékek null értékűek; az available a mért értékkel rendelkező mutatókat sorolja fel, a summary pedig mindegyikhez megadja az avg, max és last értéket. A traffic a kimenő forgalmat tartalmazza bájtban naponként és a hónap elejétől (a final értéke true, ha a nap lezárult), és null azoknál a termékeknél, amelyek nem rendelkeznek forgalomszámlálóval. A válaszokat 30 másodperctől (1h) 10 percig (14d) gyorsítótárazzuk; a meta.cached mutatja, hogy a válasz a gyorsítótárból származik-e.

HTTP 400 validation_failed: más range érték vagy ismeretlen lekérdezési paraméter. HTTP 404: ismeretlen vagy idegen szolgáltatás. HTTP 409 not_supported_for_product: ehhez a szolgáltatáshoz nem érhetők el mérések (más termékek és helyszínek). HTTP 409 service_not_active: a szolgáltatás nem aktív.

A szervermérésekre és a támadási jelentésekre az általános sebességkorlátok érvényesek. Ezen felül a gyorsítótárból ki nem szolgálható lekérések száma e három végponton együttesen fiókonként percenként legfeljebb 20; e fölött HTTP 429 választ kap Retry-After fejléccel. HTTP 502 monitoring_unavailable vagy reports_unavailable: az adatforrás átmenetileg nem érhető el, próbálja újra később. HTTP 503 temporarily_unavailable Retry-After fejléccel: egy párhuzamos kérés éppen ugyanazokat az adatokat készíti elő.

Az API-n keresztül nem érhető el: támadási jelentés az Advanced DDoS Protection szolgáltatáshoz és szerverekhez, például Edge Unlimited Traffic VPS-hez; statisztika a tiszta vagy eldobott forgalomról védett IP-címenként; CPU- és memóriaadat a hagyományos Unlimited Traffic VPS szerverekhez; webhook-kézbesítés és CSV-export.

Idempotencia

A POST /v1/orders és a POST /v1/services/{id}/actions kérésekhez Idempotency-Key fejléc szükséges (1 és 80 karakter közötti hosszúságú érték az [A-Za-z0-9_.-] karakterkészletből). A kulcs a metódushoz, az útvonalhoz és a törzshöz kötött. Ha ugyanazt a kérést egy órán belül ugyanazzal a kulccsal megismétli, a tárolt választ kapja vissza; egy óra elteltével viszont 410-es választ kap (reason: replay_stale), ilyenkor küldjön új kulcsot. Ha ugyanazt a kulcsot eltérő törzzsel vagy másik végponton használja, a szerver 409 idempotency_conflict hibával elutasítja a kérést.

Sebességkorlátok

Az alapértelmezett korlátok: kulcsonként percenként 60 kérés (plusz 20 kérésnyi burst) és naponta 5000 kérés, fiókonként az összes kulcsra együtt percenként 120 kérés, forrás-IP-címenként pedig percenként 600 kérés. Bármely korlát túllépésekor HTTP 429 választ kap Retry-After fejléccel. Az X-RateLimit-Remaining és az X-RateLimit-Reset válaszfejléc a kulcsonkénti korlát aktuális állását mutatja.