>_ NicAPI Dokumentation

REST-API von LUMASERV: Domains, DNS, SSL, Cloud-Server, IP-Adressen, Abrechnung und mehr.

Datacenter / DDoS-Alerts

GET DDoS-Angriffe abrufen API v1

GET https://connect.nicapi.eu/api/v1/datacenter/ddos-alerts

Gibt Informationen über empfangene DDoS-Angriffe zurück.

Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
DDOS_ALERTS_LIST
Filterbar
id · address · resource_misuse_sig · duration_start · duration_stop · impact_bps · impact_pps · user · created_at · updated_at · customer (nur filter) (filter, easy_filter)
Sortierbar
id · address · resource_misuse_sig · duration_start · duration_stop · impact_bps · impact_pps · user · created_at · updated_at (order)
Unbekannte Filterfelder werden ignoriert, unbekannte Sortierfelder führen zu einem Fehler. Wie Filter und Sortierung funktionieren

Dieser Endpunkt benötigt neben der Authentifizierung keine weiteren Request-Parameter (Filter und Sortierung siehe oben).

curl \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  "https://connect.nicapi.eu/api/v1/datacenter/ddos-alerts"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::get("datacenter/ddos-alerts");

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}

GET Ddos Alerts: Statistics API v1

GET https://connect.nicapi.eu/api/v1/datacenter/ddos-alerts/statistics
Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
DDOS_ALERTS_LIST
Filterbar
id · address · resource_misuse_sig · duration_start · duration_stop · impact_bps · impact_pps · user · created_at · updated_at · customer (nur filter) (filter, easy_filter)
Unbekannte Filterfelder werden ignoriert, unbekannte Sortierfelder führen zu einem Fehler. Wie Filter und Sortierung funktionieren

Dieser Endpunkt benötigt neben der Authentifizierung keine weiteren Request-Parameter (Filter und Sortierung siehe oben).

curl \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  "https://connect.nicapi.eu/api/v1/datacenter/ddos-alerts/statistics"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::get("datacenter/ddos-alerts/statistics");

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}

GET Einzelnen DDoS-Angriff abrufen API v1

GET https://connect.nicapi.eu/api/v1/datacenter/ddos-alerts/{ddos_alert}

Gibt Informationen über einen einzelnen DDoS-Angriff zurück.

Authentifizierung
API-Token erforderlich (Authorization: Bearer … oder Parameter authToken)
Benötigte Rechte
DDOS_ALERTS_LIST

Pfad-Parameter Werden direkt in die URL eingesetzt.

Name Pflicht Typ Einschränkungen Beschreibung
ddos_alert Pflicht Identifikator: DDoS-Alarm Identifikator (id) des Objekts „Ddos Alert“, Teil des Pfads.

Dieser Endpunkt benötigt neben der Authentifizierung keine weiteren Request-Parameter.

curl \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  "https://connect.nicapi.eu/api/v1/datacenter/ddos-alerts/{ddos_alert}"
use NicAPI\NicAPI;

NicAPI::init("IHR_API_TOKEN");

$result = NicAPI::get("datacenter/ddos-alerts/{ddos_alert}");

if (NicAPI::wasSuccess()) {
    $data = $result->data;
}