# De UptimeScout-API voor servicebeschikbaarheid integreren



URL: https://uptimescout.com/nl/blog/availability-api-integration/



Bouw een beschikbaarheidspaneel dat tijdstempels en onzekerheid zichtbaar houdt, in plaats van elk antwoord terug te brengen tot een gekleurd puntje.



## Zoek service-ID's op voordat je gaat pollen



Begin met het services-endpoint om de identifier te vinden die UptimeScout gebruikt. Een voor mensen leesbare merknaam is niet altijd de API-identifier. Bewaar de ID en regio in de configuratie van je applicatie, zodat status- en geschiedenisaanvragen naar dezelfde service verwijzen.

Verkrijg via Evelode een geschikte licentie en bewaar deze in een geheim aan de serverzijde of in een omgevingsvariabele. Verwerk een betaalde sleutel niet in JavaScript in de browser, een openbare repository, een schermafbeelding of een URL.



## Verstuur een geauthenticeerde statusaanvraag



Stel EVELODE_LICENSE_KEY in je eigen omgeving in voordat je het voorbeeld uitvoert. Dit voorbeeld vraagt GitHub-waarnemingen voor US op; het is een aanvraagtemplate en geen bewering over de huidige status van GitHub.



```sh

curl -G https://api.uptimescout.com/v1/status \
  --data-urlencode "service=github" \
  --data-urlencode "region=US" \
  -H "Authorization: Bearer $EVELODE_LICENSE_KEY"

```



## Interpreteer het antwoord voordat je het weergeeft



Een geslaagd transportantwoord en het beschikbaarheidssignaal van de service zijn afzonderlijke lagen. Controleer eerst de HTTP-status en de antwoordstructuur. Bekijk vervolgens service.status, service.observed_at en service.stale. Houd unknown en stale zichtbaar in plaats van ze stilzwijgend als operational te behandelen.

Sla de regio op naast het observatietijdstip. Als je eigen interface elke minuut wordt ververst, geef het observatietijdstip dan afzonderlijk weer van het tijdstip waarop je applicatie het antwoord heeft opgehaald. Een vers HTTP-antwoord kan een oudere waarneming beschrijven.



## Plan het aanvraagvolume en handel limieten af



Gebruik statuses wanneer een batch bij je workflow past en raadpleeg het gekozen abonnement voor de maximale batchgrootte. Het aanvraagtegoed en het aantal aanvragen per minuut zijn verschillende limieten. REST-, SDK- en MCP-toegang delen dezelfde gelicentieerde aanvraagadministratie.

Houd bij HTTP 429 rekening met Retry-After en voorkom een reeks onmiddellijke nieuwe pogingen. Gebruik een begrensd aantal pogingen met steeds langere tussenpozen bij tijdelijke fouten; blijf authenticatie- of parameterfouten niet eindeloos opnieuw proberen. Verlengingen en abonnementswijzigingen werken het gelicentieerde tegoed bij; er is geen reset op de eerste dag van de kalendermaand.



## Test onzekere gevallen voordat je de integratie uitrolt



Test een bekende service, een onbekende ID, een ontbrekende sleutel, ongeldige parameters en een verouderde of ontbrekende waarneming. Controleer of deze gevallen bruikbare meldingen in je interface opleveren. Neem geen volledige diagnostische resultaten op in openbare logs als die inloggegevens of accountinformatie bevatten.

De API-documentatie bevat alle zeven openbare methoden en het OpenAPI-schema. jsonscraper verwijst naar de SDK's voor Python, Node.js, PHP, Go, Java en .NET. Een clientbibliotheek vereenvoudigt het transport, maar je applicatie heeft nog steeds beleid nodig voor de interpretatie van onzekerheid.



## Bronnen

https://uptimescout.com/nl/docs/

https://uptimescout.com/nl/methodology/

https://uptimescout.com/nl/contacts/
