Overzicht
De Timezone API biedt een set eindpunten om alle beschikbare tijdzones in uw account op te halen.
Gebruiksvoorbeelden
Gebruik de Timezone API om de lokale tijd op te halen wanneer een controleregel checks uitvoert of alerts ontvangt, inclusief zomertijd (DST), indien van toepassing. Gebruik dit samen met het API-eindpunt GET /Account/Settings om de tijdzone-ID op te halen die in uw account wordt gebruikt.
Vereisten
Voordat u de Timezone API gebruikt, moet u ervoor zorgen dat u beschikt over:
- Een Enterprise-account
- Uptrends API-inloggegevens
Timezone API-velden
Wanneer u met de Timezone API-eindpunten, bevat het Timezone-object verschillende API-velden:
| Veldnaam | Beschrijving |
|---|---|
TimezoneId |
De unieke identifier van de tijdzone. |
Description |
De naam van de tijdzone. |
OffsetFromUtc |
Het verschil tussen de lokale tijd van het account en UTC in minuten. Als de lokale tijd achterloopt op UTC, geeft de waarde een negatieve offset aan. |
HasDaylightSaving |
Geeft true aan als de tijdzone DST heeft, anders false. |
DaylightSavingOffset |
Het verschil tussen de standaardtijd en de DST in minuten. |
DaylightSavingStart |
De datum en tijdstempel van wanneer de DST begint. |
DaylightSavingEnd |
De datum en tijdstempel van wanneer de DST eindigt. |
Raadpleeg Timezone API-velden voor een volledige lijst met beschikbare API-velden.
Timezone API-eindpunten
De Timezone API biedt de volgende eindpunten:
| Methode | Eindpunt | Beschrijving |
|---|---|---|
GET |
/Timezone |
Haal een lijst op met alle beschikbare tijdzones en hun configuratie. |
GET |
/Timezone/{timezoneId} |
Haal de gespecificeerde tijdzone en zijn configuratie op. |
Raadpleeg de Uptrends Timezone API-documentatie voor gedetailleerde request- en responseformaten en interactieve API-tests.
Probleemoplossing
Deze sectie behandelt veelvoorkomende HTTP-fouten en stappen voor probleemoplossing voor de Timezone API.
Veelvoorkomende fouten
Veelvoorkomende HTTP-statuscodes en hun beschrijvingen:
| Statuscode | Beschrijving |
|---|---|
| 200 | OK — request succesvol. |
| 400 | Bad request — ongeldige requestparameters of ontbrekende verplichte velden. |
| 401 | Unauthorized — ongeldige of ontbrekende authenticatiegegevens. |
| 404 | Not Found — de gespecificeerde tijdzone-ID bestaat niet. |
| 500 | Internal Server Error — er is een serverfout opgetreden. |
Algemene handleiding voor probleemoplossing
Zorg ervoor dat u:
- Altijd uw request data valideert voordat u API-calls verstuurt.
- Voor elke operation de juiste HTTP-methoden gebruikt.
Neem voor verdere ondersteuning contact op met ons Support-team.
Aanvullende artikelen
Raadpleeg de volgende artikelen voor meer informatie:
- Uptrends Timezone API-documentatie — een interactieve API-documentatie met gedetailleerde eindpuntspecificaties.
- API changelog — voor de laatste API-updates en meldingen over verouderde API’s.