Den Country-Packet-Report eines bestimmten 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/{period}.

Beschreibung

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

Voraussetzungen

Werte der Anfrage: Monat {period}

Objekte: keine

Anfrage

Um den Report eines bestimmten Monats anzufordern, fügen Sie den Monat {period} im Format YYYY-MM in den Pfad der Anfrage ein. Ein Wert in einem anderen Format führt zu einem 404-Fehler.

Als Ergebnis erhalten Sie in data eine Liste von Länder-Einträgen sowie ein Objekt meta mit Angaben zum Berichtszeitraum. Der Aufbau der Antwort entspricht der Anfrage für den aktuellen Monat. Siehe Den Country-Packet-Report des aktuellen Monats abrufen.

Für Monate ohne aggregierte Daten enthält die Antwort eine leere Liste data; last_updated_at ist in diesem Fall null.

Beispiel

Beispiel-Antwort:

{
  "data": [
    {
      "country": "DE",
      "packets": 3023924
    },
    {
      "country": "FR",
      "packets": 529490
    }
  ],
  "meta": {
    "period_start": "2026-05-01",
    "period_end": "2026-05-31",
    "last_updated_at": "2026-06-01T00:35: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.
404	Die Anfrage war nicht erfolgreich, da der angegebene Monat kein gültiges Format hat.