uptimescout
Få en API-nøkkel

UptimeScout-guide

Slik integrerer du et API for tjenestetilgjengelighet med UptimeScout

Bygg et tilgjengelighetspanel som viser tidsstempler og usikkerhet, i stedet for å redusere hvert svar til en farget prikk.

Fiber- og nettverkskontakter i et serverpanel.
KI-generert redaksjonell illustrasjon

Finn tjeneste-ID-er før du sender forespørsler

Start med tjenesteendepunktet for å finne identifikatoren UptimeScout bruker. Et lesbart merkenavn er ikke alltid API-identifikatoren. Lagre ID-en og regionen i programkonfigurasjonen, slik at status- og historikkforespørsler viser til samme tjeneste.

Skaff en gyldig lisens via Evelode, og oppbevar den som en hemmelighet på serversiden eller i en miljøvariabel. Ikke bygg en betalt nøkkel inn i JavaScript i nettleseren, et offentlig kodelager, et skjermbilde eller en URL.

Send en autentisert statusforespørsel

Angi EVELODE_LICENSE_KEY i ditt eget miljø før du kjører eksemplet. Dette eksemplet ber om GitHub-observasjoner for US; det er en forespørselsmal, ikke en påstand om GitHubs nåværende status.

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

Tolk svaret før du viser det

Et vellykket svar fra transportlaget og tjenestens tilgjengelighetssignal er to separate lag. Kontroller først HTTP-statusen og svarstrukturen. Undersøk deretter service.status, service.observed_at og service.stale. Vis unknown og utdaterte observasjoner tydelig i stedet for å behandle dem som operational uten videre.

Lagre regionen sammen med observasjonstidspunktet. Hvis grensesnittet ditt oppdateres hvert minutt, må du vise observasjonstidspunktet separat fra tidspunktet da programmet hentet svaret. Et ferskt HTTP-svar kan beskrive en eldre observasjon.

Planlegg forespørselsvolumet og håndter grenser

Bruk statuses når en batch passer arbeidsflyten din, og sjekk den valgte planen for maksimal batchstørrelse. Forespørselskvote og forespørsler per minutt er forskjellige grenser. REST-, SDK- og MCP-tilgang bruker samme lisensbaserte registrering av forespørsler.

Ved HTTP 429 må du følge Retry-After og unngå en rekke umiddelbare nye forsøk. Bruk et begrenset antall forsøk med økende ventetid ved midlertidige feil; ikke prøv på nytt i det uendelige ved autentiseringsfeil eller ugyldige parametere. Fornyelser og endringer av abonnement oppdaterer den lisensierte kvoten; den nullstilles ikke den første dagen i kalendermåneden.

Test usikre tilfeller før utrulling

Test en kjent tjeneste, en ukjent ID, en manglende nøkkel, ugyldige parametere og en utdatert eller manglende observasjon. Kontroller at disse tilfellene gir nyttige meldinger i grensesnittet. Ikke ta med hele feilsøkingsresultatet i offentlige logger hvis det inneholder påloggingsopplysninger eller kontoinformasjon.

API-dokumentasjonen inneholder alle sju offentlige metodene og OpenAPI-skjemaet. jsonscraper lenker til Python-, Node.js-, PHP-, Go-, Java- og .NET-SDK-ene. Et klientbibliotek forenkler transportlaget, men programmet ditt trenger fortsatt en policy for hvordan usikkerhet skal tolkes.

Innholdet ble gjennomgått 18. november 2026.

Markdown

REST / MCP / SDK

Sjekk en tjeneste eller integrer API-et

Bruk tjenestekatalogen for et oppdatert regionalt signal og dokumentasjonen for en reproduserbar integrasjon.

TjenestekatalogAPI-dokumentasjon