Den Country-Packet-Report des aktuellen Monats abrufen

Note

Dieser Endpunkt verwendet nicht die reguläre DataHub-API-Authentifizierung. Die Authentifizierung erfolgt über ein separates statisches Token (Konfigurationswert COUNTRY_STATS_API_TOKEN), das als Bearer-Token im Authorization-Header übermittelt wird.

Senden einer GET-Anfrage an den Endpunkt /country-packet-reports.

Beschreibung

Mit der List-Country-Packet-Reports-Anfrage fordern Sie den aggregierten Country-Packet-Report des aktuellen Monats an. Der Report enthält pro Land die Summe der Pakete aus den im Berichtsmonat beendeten Mitigationen, absteigend nach Paketanzahl sortiert.

Das System aggregiert die Daten stündlich neu. Die Aggregation setzt das Feature-Flag COUNTRY_STATS_ENABLED voraus; andernfalls bleibt der Report leer.

Voraussetzungen

Werte der Anfrage: keine

Objekte: keine

Anfrage

Um den Report des aktuellen Monats anzufordern, ist keine zusätzliche Information im Pfad der Anfrage erforderlich.

Als Ergebnis erhalten Sie in data eine Liste von Länder-Einträgen sowie ein Objekt meta mit Angaben zum Berichtszeitraum.

Die Länder-Einträge liefern die folgenden Informationen:

Attribut	Beschreibung	Werte
country	Der ISO-Ländercode des Landes.	string
packets	Die aggregierte Anzahl der Pakete für das Land im Berichtsmonat.	integer

Das Objekt meta liefert die folgenden Informationen:

Attribut	Beschreibung	Werte
period_start	Der erste Tag des Berichtsmonats im Format YYYY-MM-DD.	string($date)
period_end	Der letzte Tag des Berichtsmonats im Format YYYY-MM-DD.	string($date)
last_updated_at	Datum und Uhrzeit der letzten Aggregation im ISO-8601-Format; null, wenn noch keine Daten aggregiert wurden.	string($date-time)

Beispiel

Beispiel-Antwort:

{
  "data": [
    {
      "country": "DE",
      "packets": 3023924
    },
    {
      "country": "US",
      "packets": 953069
    },
    {
      "country": "NL",
      "packets": 561701
    }
  ],
  "meta": {
    "period_start": "2026-06-01",
    "period_end": "2026-06-30",
    "last_updated_at": "2026-06-30T23:05:00+00:00"
  }
}

Antworten

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
200	Die Anfrage war erfolgreich.
401	Die Anfrage war nicht erfolgreich, da der Authorization-Header fehlt oder kein Bearer-Token enthält.
403	Die Anfrage war nicht erfolgreich, da das übermittelte Token ungültig ist.