1. Ondersteuning
  2. Knowledge Base
  3. Uptrends' API
  4. API-velden
  5. PresetPeriod API-veld

PresetPeriod API-veld

PresetPeriod

Met het veld PresetPeriod kunt u API-responses filteren door te selecteren uit een lijst met voorgedefinieerde tijdsperiodes. Gebruik dit veld wanneer u algemene tijdsperiodes nodig hebt, zoals de afgelopen 7 dagen of de huidige maand. Gebruik voor aangepaste datumbereiken de parameters Start en End.

Opmerking: U kunt PresetPeriod niet combineren met de parameters Start en End in dezelfde API-call. Als u geen vooringestelde periode instelt, wordt dit standaard ingesteld op Last24Hours.

Beschikbare opties

De volgende periodeopties zijn beschikbaar, gecategoriseerd per type:

Huidige periodes

  • CurrentDay
  • CurrentWeek
  • CurrentMonth
  • CurrentQuarter
  • CurrentYear

Vorige periodes

  • PreviousDay
  • PreviousWeek
  • PreviousMonth
  • PreviousQuarter
  • PreviousYear

Laatste X periodes

In uren:

  • Last2Hours
  • Last6Hours
  • Last12Hours
  • Last24Hours
  • Last48Hours

In dagen:

  • Last7Days
  • Last30Days
  • Last60Days
  • Last90Days
  • Last365Days

In maanden:

  • Last3Months
  • Last6Months
  • Last12Months
  • Last24Months

PresetPeriod gebruiken

Om PresetPeriod in een API-request te gebruiken, voegt u het toe als queryparameter:

GET https://api.uptrends.com/v4/Statistics/Monitor/ef42495b-26cb-4a2f-8cfc-c933f9716d22?PresetPeriod=PreviousYear

Vorige en laatste periodes bevatten alleen volledige tijdsperiodes. Onvolledige periodes worden uitgesloten.

Voorbeelden

Als u PresetPeriod=Last7Days instelt en data opvraagt op maandag 20 januari 2025 om 8:00 uur, ontvangt u data van maandag 13 januari tot en met zondag 19 januari (zeven voltooide dagen). Maandag 20 januari is niet inbegrepen omdat dit een onvolledige dag is.

Evenzo, als u PresetPeriod=Last12Months instelt en data opvraagt op 25 januari 2025, ontvangt u resultaten van december 2023 tot en met december 2024, aangezien de maand januari nog niet voltooid is.

Door deze website te gebruiken, stemt u in met het gebruik van cookies in overeenstemming met ons Cookiebeleid.