Endpoint-referentie

KernelHost API

Alle endpoints leveren application/json. Fouten volgen RFC 7807 (Problem+JSON). Elke response bevat een X-Request-Id-header voor correlatie met het serverzijdige auditlogboek.

MethodPathMachtigingDoel
GET/v1/healthpublicHealth-check zonder authenticatie.
GET/v1/meanyEigen accountgegevens plus sleutel-metadata.
GET/v1/productsread:productsLijst van alle openbaar vermelde producten met prijzen.
GET/v1/products/{id}read:productsProductdetails inclusief configuratie-opties.
POST/v1/orderswrite:ordersBestelling plaatsen. Idempotency-Key verplicht.
GET/v1/orders/{id}read:ordersStatus van een eigen bestelling.
GET/v1/servicesread:servicesLijst van eigen services (gepagineerd).
GET/v1/services/{id}read:servicesDetails van een eigen service.
GET/v1/services/{id}/credentialsread:credentialsService-toegangsgegevens (aparte machtiging, audit-gelogd).
POST/v1/services/{id}/actionswrite:servicesService-actie: start, stop, reboot, cancel (per einde van de factureringsperiode), cancel_revoke.
GET/v1/services/{id}/metricsread:servicesServermetingen van een eigen dienst (CPU, geheugen, netwerk).
GET/v1/services/{id}/ddos/profilesread:ddosBeschikbare Advanced DDoS Protection-profielen.
GET/v1/services/{id}/ddos/rulesread:ddosHuidige regels voor het toegewezen beschermde IP-adres.
POST/v1/services/{id}/ddos/ruleswrite:ddosEén beschermingsregel toevoegen. Idempotency-Key verplicht.
DELETE/v1/services/{id}/ddos/rules/{rule_id}write:ddosEén eigen regel verwijderen. Idempotency-Key verplicht.
GET/v1/services/{id}/ddos/attacksread:ddosGedetecteerde aanvallen op het beschermde IP-adres (Remote DDoS Protection).
GET/v1/services/{id}/ddos/attacks/{attack_id}read:ddosDetails van één aanval: verkeer en uitsplitsingen.
GET/v1/billing/balanceread:billingTegoed.
GET/v1/billing/invoicesread:billingLijst van uw facturen (gepagineerd).
GET/v1/billing/invoices/{id}/pdfread:billingFactuur-PDF.
GET/v1/webhooksread:webhooksHuidige webhook-URL.
PUT/v1/webhookswrite:webhooksWebhook-URL instellen of verwijderen.

Advanced DDoS Protection-regels

Deze endpoints vereisen een Advanced DDoS Protection-dienst van uw eigen account. Lezen kan bij status active of suspended; wijzigingen vereisen status active. Schakel read:ddos voor lezen en write:ddos voor wijzigingen expliciet in op uw API-sleutel. Bestaande sleutels krijgen niet automatisch nieuwe rechten. Beheer van tunnels en whitelists is niet beschikbaar.

Kies app_code uit de profielcatalogus. port moet een geheel getal van 1 tot en met 65535 zijn; laat het bij icmp weg of stuur 0. Het optionele extra_ports koppelt exacte profielnamen aan gehele poortnummers; weggelaten namen behouden de profielstandaarden. De server bepaalt de protocollen, dus stuur geen protocol. Onbekende velden of namen leveren HTTP 400 op.

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 retourneert HTTP 201 met de aangemaakte regel in data. GET retourneert de regels en meta met service_id, protection_ip en max_rules. DELETE gebruikt een lege body en retourneert HTTP 200 zoals hieronder. Voor POST en DELETE is Idempotency-Key verplicht.

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

Paneel en API delen vaste UTC-vensters: 10 schrijfpogingen per minuut per account, 5 per minuut per beschermd IP-adres en 200 per UTC-dag per account. Toegelaten ongeldige of mislukte pogingen tellen mee; geslaagde idempotente herhalingen niet. DDoS-leesverzoeken via de API delen 30 verzoeken per minuut per account. Maximaal 1000 regels per beschermd IP-adres.

HTTP 404: onbekende dienst of dienst van een ander account, regel van een ander account, ontbrekende regel of systeemregel. HTTP 409: geen Advanced DDoS Protection-dienst (not_supported_for_product), inactieve dienst, poortconflict of gelijktijdige wijziging. HTTP 429: limiet bereikt, respecteer Retry-After. HTTP 502: de beschermingsdienst kon het verzoek niet afronden. De systeemregel block is verborgen en kan niet worden verwijderd. HTTP 503: de controle van de verzoeklimieten is tijdelijk niet beschikbaar, respecteer Retry-After.

DDoS-aanvalsrapporten

Deze endpoints vereisen een Remote DDoS Protection-dienst van uw eigen account met status active of suspended en de scope read:ddos, die expliciet moet worden ingeschakeld. De lijst toont de DDoS-aanvallen die op het beschermde IP-adres van de dienst zijn gedetecteerd, de nieuwste eerst.

Queryparameters: from en to als datum (YYYY-MM-DD) of als ISO 8601-datum met tijd en tijdzone (standaard: de laatste 30 dagen), limit van 1 tot en met 100 (standaard 25) en offset van 0 tot en met 9999 (standaard 0). De periode reikt nooit verder terug dan 90 dagen en nooit tot vóór het moment waarop het beschermde IP-adres aan deze dienst is toegewezen; meta.from en meta.to tonen de werkelijk gebruikte periode.

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

Elke aanval bevat id (UUID), type (ddos_attack, of blackhole als het doel-IP-adres tijdelijk via een nulroute werd geblokkeerd), started_at, ended_at (kan null zijn), detected_bps, detected_pps, source_ip_count, target_ip en details_available. detected_bps en detected_pps geven de snelheid op het moment van detectie; de filtering was toen al begonnen, dus ze kunnen lager zijn dan de piek in de details. paging bevat limit, offset, total en truncated (true als de periode meer dan 500 aanvallen bevat), meta bevat service_id, protected_ip, from, to en retention_days (90). Lijsten worden 60 seconden in de cache bewaard.

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

De details bevatten alle velden van de lijst plus peak_bps, peak_pps, total_bytes, total_packets en interval_seconds. traffic geeft het inkomende aanvalsverkeer per interval ({time, bps, pps}) zoals het filternetwerk dat zag, van ongeveer 10 minuten vóór tot ongeveer 10 minuten na de detectie. De uitsplitsingen protocols, destination_ports, source_ports, source_countries, source_ips en packet_sizes bevatten meestal de 5 grootste posten: avg_bps en avg_pps zijn gemiddelden over het meetvenster, bps_percent en pps_percent zijn aandelen. protocols bevat daarnaast bytes en packets, packet_sizes bevat range, avg_bps en percent. Details worden tot 15 minuten in de cache bewaard.

HTTP 400 validation_failed: ongeldige waarde of onbekende queryparameter. HTTP 404: onbekende dienst of dienst van een ander account, onbekende aanval-ID of aanval op een ander IP-adres. HTTP 409 not_supported_for_product: geen Remote DDoS Protection-dienst (bijvoorbeeld Advanced DDoS Protection of een server). HTTP 409 service_not_active: de dienst heeft niet de status active of suspended. HTTP 409 protection_not_ready: de bescherming wordt nog ingericht.

Servermetingen

Dit endpoint vereist een actieve dienst van uw eigen account en de scope read:services. Edge Unlimited Traffic VPS leveren meetwaarden voor CPU, geheugen en netwerk inkomend en uitgaand (bit/s en pakketten/s), plus het uitgaande verkeer per dag en sinds het begin van de maand. Reguliere Unlimited Traffic VPS op de locaties Europa, Duitsland, Frankrijk, Canada Oost, het Verenigd Koninkrijk en Polen leveren alleen meetwaarden voor netwerk inkomend en uitgaand in bit/s.

Queryparameter range: 1h, 6h, 24h, 7d of 14d (standaard 1h). De afstand tussen de meetpunten hangt af van de periode: bij Edge Unlimited Traffic VPS ongeveer 15 seconden (1h), 20 seconden (6h), 2 minuten (24h), 10 minuten (7d) en 20 minuten (14d); bij reguliere Unlimited Traffic VPS 5 minuten tot en met 24h, 30 minuten bij 7d en 2 uur bij 14d. step_seconds toont de afstand in het antwoord.

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 waarden worden gemeten op de netwerkinterface van de server en tonen dus het verkeer dat de server werkelijk heeft bereikt. Voor het geheugen is de guest agent in de server nodig. Waarden die niet konden worden gemeten zijn null; available noemt de metingen met gemeten waarden en summary geeft daarvan telkens avg, max en last. traffic bevat het uitgaande verkeer in bytes per dag en sinds het begin van de maand (final is true zodra een dag is afgesloten) en is null bij producten zonder verkeersteller. Antwoorden worden 30 seconden (1h) tot 10 minuten (14d) in de cache bewaard; meta.cached toont of het antwoord uit de cache kwam.

HTTP 400 validation_failed: andere waarde voor range of onbekende queryparameter. HTTP 404: onbekende dienst of dienst van een ander account. HTTP 409 not_supported_for_product: voor deze dienst zijn geen metingen beschikbaar (andere producten en locaties). HTTP 409 service_not_active: de dienst is niet actief.

Voor servermetingen en aanvalsrapporten gelden de algemene snelheidsbeperkingen. Daarnaast zijn ophaalverzoeken die niet uit de cache kunnen worden beantwoord beperkt tot 20 per minuut per account voor deze drie endpoints samen; daarboven krijgt u HTTP 429 met Retry-After. HTTP 502 monitoring_unavailable of reports_unavailable: de gegevensbron is tijdelijk niet beschikbaar, probeer het later opnieuw. HTTP 503 temporarily_unavailable met Retry-After: een parallel verzoek bereidt dezelfde gegevens op dit moment voor.

Niet beschikbaar via de API: aanvalsrapporten voor Advanced DDoS Protection en voor servers zoals Edge Unlimited Traffic VPS; statistieken van schoon of verworpen verkeer per beschermd IP-adres; CPU en geheugen bij reguliere Unlimited Traffic VPS; aflevering van webhooks en CSV-export.

Idempotentie

POST /v1/orders en POST /v1/services/{id}/actions vereisen de header Idempotency-Key (1 tot 80 tekens uit [A-Za-z0-9_.-]). De key is gebonden aan methode, pad en body. Herhaalt u dezelfde aanvraag binnen een uur met dezelfde key, dan krijgt u de opgeslagen response terug; daarna volgt 410 met reason replay_stale en moet u een nieuwe key sturen. Dezelfde key met een andere body of op een ander endpoint wordt afgewezen met 409 idempotency_conflict.

Snelheidsbeperkingen

Standaard 60 aanvragen per minuut (plus een burst van 20) en 5.000 per dag per sleutel, 120 per minuut per account over alle sleutels heen en 600 per minuut per bron-IP. Wordt een limiet overschreden, dan krijgt u HTTP 429 met de header Retry-After. De response-headers X-RateLimit-Remaining en X-RateLimit-Reset tonen de actuele stand van de limiet per sleutel.