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


