Toate endpointurile returnează application/json. Erorile respectă RFC 7807 (Problem+JSON). Fiecare răspuns include antetul X-Request-Id pentru corelarea cu jurnalul de audit de pe server.
| Method | Path | Permisiune | Scop |
|---|---|---|---|
| GET | /v1/health | public | Verificare de sănătate fără autentificare. |
| GET | /v1/me | any | Informații despre cont și metadate ale cheii. |
| GET | /v1/products | read:products | Lista tuturor produselor listate public, cu prețuri. |
| GET | /v1/products/{id} | read:products | Detalii despre produs, inclusiv opțiunile de configurare. |
| POST | /v1/orders | write:orders | Plasarea unei comenzi. Idempotency-Key obligatoriu. |
| GET | /v1/orders/{id} | read:orders | Starea unei comenzi proprii. |
| GET | /v1/services | read:services | Lista propriilor servicii (paginate). |
| GET | /v1/services/{id} | read:services | Detalii despre un serviciu propriu. |
| GET | /v1/services/{id}/credentials | read:credentials | Credențiale ale serviciului (permisiune separată, înregistrate în audit). |
| POST | /v1/services/{id}/actions | write:services | Acțiune asupra serviciului: start, stop, reboot, cancel (la sfârșitul perioadei de facturare), cancel_revoke. |
| GET | /v1/services/{id}/metrics | read:services | Metrici de server ale unui serviciu propriu (CPU, memorie, rețea). |
| GET | /v1/services/{id}/ddos/profiles | read:ddos | Profiluri Advanced DDoS Protection disponibile. |
| GET | /v1/services/{id}/ddos/rules | read:ddos | Regulile actuale ale IP-ului protejat alocat. |
| POST | /v1/services/{id}/ddos/rules | write:ddos | Adăugați o regulă de protecție. Idempotency-Key este obligatoriu. |
| DELETE | /v1/services/{id}/ddos/rules/{rule_id} | write:ddos | Ștergeți o regulă proprie. Idempotency-Key este obligatoriu. |
| GET | /v1/services/{id}/ddos/attacks | read:ddos | Atacuri detectate pe IP-ul protejat (Remote DDoS Protection). |
| GET | /v1/services/{id}/ddos/attacks/{attack_id} | read:ddos | Detaliile unui atac: trafic și defalcări. |
| GET | /v1/billing/balance | read:billing | Soldul de credit. |
| GET | /v1/billing/invoices | read:billing | Lista facturilor dumneavoastră (paginate). |
| GET | /v1/billing/invoices/{id}/pdf | read:billing | PDF-ul facturii. |
| GET | /v1/webhooks | read:webhooks | Adresa URL curentă a webhookului. |
| PUT | /v1/webhooks | write:webhooks | Setarea sau eliminarea adresei URL pentru webhook. |
Reguli Advanced DDoS Protection
Aceste endpointuri necesită un serviciu Advanced DDoS Protection care aparține contului dumneavoastră. Citirea este disponibilă în starea active sau suspended; modificările necesită starea active. Activați explicit read:ddos pentru citire și write:ddos pentru modificări pe cheia API. Cheile existente nu primesc automat permisiuni noi. Administrarea tunelurilor și a listei de adrese permise nu este disponibilă.
Alegeți app_code din catalogul de profiluri. port trebuie să fie un număr întreg între 1 și 65535; pentru icmp, omiteți-l sau trimiteți 0. Obiectul opțional extra_ports asociază etichetele exacte din profil cu porturi întregi; etichetele omise păstrează valorile implicite ale profilului. Protocoalele sunt stabilite de server, deci nu trimiteți protocol. Câmpurile sau etichetele necunoscute returnează HTTP 400.
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 returnează HTTP 201 cu regula creată în data. GET returnează regulile și meta cu service_id, protection_ip și max_rules. DELETE folosește un corp gol și returnează HTTP 200 ca în exemplul de mai jos. POST și DELETE necesită Idempotency-Key.
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}}
Panoul și API-ul folosesc ferestre UTC fixe comune: 10 încercări de scriere pe minut și cont, 5 pe minut și IP protejat și 200 pe zi UTC și cont. Încercările admise, dar invalide sau eșuate, sunt numărate; repetările idempotente reușite nu sunt numărate. Citirile DDoS prin API au o limită comună de 30 de cereri pe minut și cont. Maximum 1000 de reguli pe IP protejat.
HTTP 404: serviciu necunoscut sau străin, ori regulă străină, inexistentă sau de sistem. HTTP 409: nu este un serviciu Advanced DDoS Protection (not_supported_for_product), serviciu inactiv, conflict de porturi sau modificare simultană. HTTP 429: limită atinsă, respectați Retry-After. HTTP 502: serviciul de protecție nu a putut finaliza cererea. Regula de sistem block este ascunsă și nu poate fi ștearsă. HTTP 503: verificarea limitelor de cereri este temporar indisponibilă, respectați Retry-After.
Rapoarte privind atacurile DDoS
Aceste endpointuri necesită un serviciu Remote DDoS Protection care aparține contului dumneavoastră, în starea active sau suspended, și permisiunea read:ddos, care trebuie activată explicit. Lista arată atacurile DDoS detectate pe adresa IP protejată a serviciului, începând cu cele mai recente.
Parametri de interogare: from și to ca dată (YYYY-MM-DD) sau ca dată și oră ISO 8601 cu fus orar (implicit: ultimele 30 de zile), limit între 1 și 100 (implicit 25) și offset între 0 și 9999 (implicit 0). Intervalul nu merge niciodată mai mult de 90 de zile în urmă și nici înainte de momentul în care adresa IP protejată a fost alocată acestui serviciu; meta.from și meta.to arată intervalul folosit efectiv.
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}
}
Fiecare atac conține id (UUID), type (ddos_attack sau blackhole, dacă IP-ul țintă a fost blocat temporar prin rutare nulă), started_at, ended_at (poate fi null), detected_bps, detected_pps, source_ip_count, target_ip și details_available. detected_bps și detected_pps indică rata din momentul detectării; filtrarea pornise deja, de aceea pot fi mai mici decât vârful din detalii. paging conține limit, offset, total și truncated (true dacă intervalul cuprinde peste 500 de atacuri), meta conține service_id, protected_ip, from, to și retention_days (90). Listele sunt păstrate în cache timp de 60 de secunde.
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}
}
Detaliile conțin toate câmpurile din listă, plus peak_bps, peak_pps, total_bytes, total_packets și interval_seconds. traffic enumeră traficul de atac primit pe fiecare interval ({time, bps, pps}), așa cum l-a văzut rețeaua de filtrare, de la circa 10 minute înainte până la circa 10 minute după detectare. Defalcările protocols, destination_ports, source_ports, source_countries, source_ips și packet_sizes conțin de regulă primele 5 intrări: avg_bps și avg_pps sunt medii pe fereastra de măsurare, bps_percent și pps_percent sunt ponderi. protocols conține în plus bytes și packets, packet_sizes conține range, avg_bps și percent. Detaliile sunt păstrate în cache până la 15 minute.
HTTP 400 validation_failed: valoare invalidă sau parametru de interogare necunoscut. HTTP 404: serviciu necunoscut sau străin, ID de atac necunoscut ori atac asupra altei adrese IP. HTTP 409 not_supported_for_product: nu este un serviciu Remote DDoS Protection (de exemplu Advanced DDoS Protection sau un server). HTTP 409 service_not_active: serviciul nu este nici active, nici suspended. HTTP 409 protection_not_ready: protecția este încă în curs de configurare.
Metrici de server
Acest endpoint necesită un serviciu activ al contului dumneavoastră și permisiunea read:services. Edge Unlimited Traffic VPS furnizează date despre CPU, memorie și rețea la intrare și la ieșire (bit/s și pachete/s), plus traficul de ieșire pe zi și de la începutul lunii. VPS-urile Unlimited Traffic din gama obișnuită, în locațiile Europa, Germania, Franța, Canada de Est, Regatul Unit și Polonia, furnizează doar date despre rețea la intrare și la ieșire în bit/s.
Parametru de interogare range: 1h, 6h, 24h, 7d sau 14d (implicit 1h). Distanța dintre puncte depinde de interval: la Edge Unlimited Traffic VPS circa 15 secunde (1h), 20 de secunde (6h), 2 minute (24h), 10 minute (7d) și 20 de minute (14d); la VPS-urile Unlimited Traffic din gama obișnuită 5 minute până la 24h, 30 de minute pentru 7d și 2 ore pentru 14d. step_seconds arată distanța din răspuns.
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"}
}
Valorile sunt măsurate la interfața de rețea a serverului, deci arată traficul care a ajuns efectiv la server. Memoria necesită agentul guest instalat în server. Valorile care nu au putut fi măsurate sunt null; available enumeră metricile cu valori măsurate, iar summary arată pentru fiecare avg, max și last. traffic conține traficul de ieșire în octeți pe zi și de la începutul lunii (final este true după încheierea zilei) și este null la produsele fără contor de trafic. Răspunsurile sunt păstrate în cache între 30 de secunde (1h) și 10 minute (14d); meta.cached arată dacă răspunsul provine din cache.
HTTP 400 validation_failed: altă valoare pentru range sau parametru de interogare necunoscut. HTTP 404: serviciu necunoscut sau străin. HTTP 409 not_supported_for_product: nu există metrici pentru acest serviciu (alte produse și locații). HTTP 409 service_not_active: serviciul nu este activ.
Pentru metricile de server și rapoartele privind atacurile se aplică limitele generale de rată. În plus, preluările care nu pot fi servite din cache sunt limitate la 20 pe minut și cont pentru aceste trei endpointuri împreună; peste această limită primiți HTTP 429 cu Retry-After. HTTP 502 monitoring_unavailable sau reports_unavailable: sursa de date este temporar indisponibilă, reîncercați mai târziu. HTTP 503 temporarily_unavailable cu Retry-After: o cerere paralelă pregătește chiar acum aceleași date.
Nu sunt disponibile prin API: rapoarte privind atacurile pentru Advanced DDoS Protection și pentru servere precum Edge Unlimited Traffic VPS; statistici despre traficul curat sau eliminat pe IP protejat; CPU și memorie pentru VPS-urile Unlimited Traffic din gama obișnuită; livrarea webhookurilor și exportul CSV.
Idempotență
POST /v1/orders și POST /v1/services/{id}/actions necesită un antet Idempotency-Key (între 1 și 80 de caractere din [A-Za-z0-9_.-]). Cheia este legată de metodă, cale și corp. Dacă repetați aceeași cerere cu aceeași cheie în decurs de o oră, primiți răspunsul memorat; după aceea primiți 410 cu reason replay_stale și trebuie să trimiteți o cheie nouă. Aceeași cheie folosită cu un alt corp sau pe un alt endpoint este respinsă cu 409 idempotency_conflict.
Limitare a ratei
Implicit se aplică 60 de cereri pe minut (plus un burst de 20) și 5.000 pe zi per cheie, 120 pe minut per cont pentru toate cheile împreună și 600 pe minut per IP sursă. La depășirea unei limite primiți HTTP 429 cu antetul Retry-After. Antetele de răspuns X-RateLimit-Remaining și X-RateLimit-Reset indică starea curentă a limitei pentru cheie.

