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
Diese Optionen decken den aktuellen, unvollständigen Zeitraum vom Beginn des Zeitraums bis zum aktuellen Zeitpunkt ab:
CurrentDayCurrentWeekCurrentMonthCurrentQuarterCurrentYear
Vorherige Zeiträume
Diese Optionen decken den vollständigen Zeitraum, der vorherig beendet wurde:
PreviousDayPreviousWeekPreviousMonthPreviousQuarterPreviousYear
„Letzte X‟-Zeiträume
Diese Optionen decken eine Reihe bestimmter vollständiger Zeiträume ab, vom aktuellen Zeitpunkt rückwärts zählend: Der aktuelle unvollständige Zeitraum ist nicht standardmäßig enthalten.
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 Daten 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.