Auswertung der geografischen Anfrageverteilung einer Domain oder Subdomain abrufen¶

Note

Sie müssen im ausgewählten Zeitraum mindestens READ-Berechtigungen besitzen.

Note

Domains und Subdomains, für die keine Berechtigungen bestehen, werden übersprungen.

Note

Im Body muss mindestens eines der Attribute domains oder subDomains definiert sein.

Senden einer POST-Anfrage an den Endpunkt /statistics/world-map/{startTime}/{finishTime}/{sortBy}/{direction}.

Beschreibung¶

Mit der Get-Worldmap-Anfrage rufen Sie länderbezogene Anfragestatistiken für die angegebenen Domains oder Subdomains für den ausgewählten Zeitraum ab, geeignet für die Visualisierung auf einer Weltkarte.

Voraussetzungen¶

Werte der Anfrage: Startdate {startTime}; Enddate {finishTime}; Sorting {sortBy}; Order {direction}

Objekte: StatisticsVO

Anfrage¶

Um Daten für eine bestimmte Weltkarte für eine oder mehrere Domains oder Subdomains abzurufen, fügen Sie die Start- und Endzeit als Unix-Zeitstempel sowie die Attribute Sorting {sortBy} und Order {direction} dem Pfad der Anfrage hinzu.

Die Werte für Sorting {sortBy} sind die folgenden:

Wert	Beschreibung
`total_cached_requests`	Sortieren nach der Gesamtzahl der zwischengespeicherten Anfragen.
`total_cached_traffic`	Sortieren nach der Gesamtmenge des zwischengespeicherten Traffics.
`total_requests`	Sortieren nach der Gesamtzahl der Anfragen.
`total_traffic`	Sortieren nach der Gesamtmenge des Traffics.
`total_uncached_requests`	Sortieren nach der Gesamtzahl der nicht zwischengespeicherten Anfragen.
`total_uncached_traffic`	Sortieren nach der Menge des nicht zwischengespeicherten Traffics.
`country_code`	Sortieren nach dem Ländercode des Landes.
`total_blocked_requests`	Sortieren nach der Gesamtzahl der blockierten Anfragen.
`total_redirect_requests`	Sortieren nach der Gesamtzahl der weitergeleiteten Anfragen.
`total_verified_requests`	Sortieren nach der Gesamtzahl der verifizierten Anfragen.

Die Werte für Order {direction} sind die folgenden:

Wert	Beschreibung
`desc`	Sortiert die Einträge absteigend.
`asc`	Sortiert die Einträge aufsteigend.

Für eine detaillierte Spezifikation, welche Informationen zum Abrufen einer Statistik erforderlich sind, müssen im Body die folgenden Attribute definiert werden:

Attribut	Beschreibung	Werte
`domains`	Ein Array mit den Namen der Domains.HinweisUm eine Domain mit allen ihren Subdomains aufzunehmen, muss das Attribut `subDomains` leer sein.	`string`
`subDomains`	Ein Array mit den Namen der Subdomains.HinweisUm nur bestimmte Subdomains aufzunehmen, kann das Attribut `Domains` leer sein.	`string`

Als Ergebnis erhalten Sie ein oder mehrere Statistikobjekte mit Daten für jede Analysekategorie für die ausgewählten Domains oder Subdomains.

Das Objekt liefert die folgenden Informationen:

Attribut	Beschreibung	Werte
`astype`	Der ASN-Typ mit dem Namen der Region.	`string`
`total_cached_requests`	Die Gesamtzahl der zwischengespeicherten Anfragen.	`integer`
`total_cached_traffic`	Die Gesamtmenge des zwischengespeicherten Traffics.	`integer`
`total_requests`	Die Gesamtzahl der Anfragen.	`integer`
`total_traffic`	Die Gesamtmenge des Traffics.	`integer`
`total_uncached_requests`	Die Gesamtzahl der nicht zwischengespeicherten Anfragen.	`integer`
`total_uncached_traffic`	Die Menge des nicht zwischengespeicherten Traffics.	`integer`
`country_code`	Der Ländercode des Landes.	`string`
`total_blocked_requests`	Die Gesamtzahl der blockierten Anfragen.	`integer`
`total_redirect_requests`	Die Gesamtzahl der weitergeleiteten Anfragen.	`integer`
`total_verified_requests`	Die Gesamtzahl der verifizierten Anfragen.	`integer`

Beispiel¶

Beispiel-Request-Body:

{
  "domains": "string",
  "subDomains": "string",
  "astype": "string",
  "total_cached_requests": 0,
  "total_cached_traffic": 0,
  "total_requests": 0,
  "total_traffic": 0,
  "total_uncached_requests": 0,
  "total_uncached_traffic": 0,
  "country_code": "string",
  "total_blocked_requests": 0,
  "total_redirect_requests": 0,
  "total_verified_requests": 0
}

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
201	Die Anfrage war erfolgreich und ein neues Objekt wurde erstellt.
400	Die Anfrage war nicht erfolgreich. Die Anfrage war fehlerhaft oder es fehlen Informationen.
401	Die Anfrage war nicht erfolgreich, da die Authentifizierung fehlerhaft war.
403	Die Anfrage war nicht erfolgreich, da die erforderlichen Berechtigungen fehlen.