PresetPeriod
Das Feld PresetPeriod ermöglicht das Filtern nach API-Antworten, indem eine Auswahl von einer Liste vordefinierter Zeiträume stattfindet. Verwende dieses Feld, wenn du typische Zeiträume wie die letzten 7 Tage oder den aktuellen Monat benötigst. Für benutzerdefinierte Zeiträume gib stattdessen die Parameter Start und End an.
Optionen
Die folgenden Zeiträume sind verfügbar, nach Typ kategorisiert:
Aktuelle Zeiträume
CurrentDayCurrentWeekCurrentMonthCurrentQuarterCurrentYear
Vorherige Zeiträume
PreviousDayPreviousWeekPreviousMonthPreviousQuarterPreviousYear
„Letzte X‟-Zeiträume
Nach Stunden:
Last2HoursLast6HoursLast12HoursLast24HoursLast48Hours
Nach Tagen:
Last7DaysLast30DaysLast60DaysLast90DaysLast365Days
Nach Monat:
Last3MonthsLast6MonthsLast12MonthsLast24Months
PresetPeriod nutzen
Um PresetPeriod bei einer API-Abfrage zu nutzen, füge es als Query-Parameter ein:
GET https://api.uptrends.com/v4/Statistics/Monitor/ef42495b-26cb-4a2f-8cfc-c933f9716d22?PresetPeriod=PreviousYear
Vorherige und letzte Zeiträume umfassen nur komplette Zeiträume: Nicht vollständige Zeiträume werden ausgeschlossen.
Beispiele
Wenn du PresetPeriod=Last7Days angibst und Datem am Montag, den 20. Januar 2025 um 8:00 Uhr abrufst, erhältst du Daten von Montag, dem 13. Januar bis Sonntag, dem 19. Januar (sieben vollständige Tage). Für Montag, der 20. Januar gibt es keine Daten, da es kein kompletter Tag ist.
Ähnliches gilt für PresetPeriod=Last12Months und Abfrage der Daten am 25. Januar 2025: Du erhältst die Daten ab Dezember 2023 bis einschließlich Dezember 2024, da der Monat Januar noch nicht abgeschlossen ist.