Hitta tjänste-ID:n innan du börjar hämta status
Börja med tjänsteslutpunkten för att hitta den identifierare som UptimeScout använder. Ett namn som är lätt att läsa är inte alltid samma sak som API-identifieraren. Spara ID:t och regionen i applikationens konfiguration så att status- och historikförfrågningar avser samma tjänst.
Skaffa en giltig licens via Evelode och förvara den i en hemlighet på serversidan eller i en miljövariabel. Bädda inte in en betald nyckel i JavaScript i webbläsaren, ett offentligt kodarkiv, en skärmbild eller en URL.
Skicka en autentiserad statusförfrågan
Ange EVELODE_LICENSE_KEY i din egen miljö innan du kör exemplet. Exemplet begär GitHub-observationer för US; det är en mall för en förfrågan, inte ett påstående om GitHubs aktuella status.
curl -G https://api.uptimescout.com/v1/status \
--data-urlencode "service=github" \
--data-urlencode "region=US" \
-H "Authorization: Bearer $EVELODE_LICENSE_KEY"Tolka svaret innan du visar det
Ett lyckat transportsvar och tjänstens tillgänglighetssignal är två separata nivåer. Validera först HTTP-statusen och svarskuvertet. Kontrollera sedan service.status, service.observed_at och service.stale. Visa unknown och inaktuella resultat tydligt i stället för att tyst behandla dem som operational.
Spara regionen tillsammans med observationstiden. Om ditt eget gränssnitt uppdateras varje minut ska du visa observationstiden separat från den tidpunkt då applikationen hämtade svaret. Ett aktuellt HTTP-svar kan beskriva en äldre observation.
Planera förfrågningsvolymen och hantera gränser
Använd statuses när en batch passar arbetsflödet och kontrollera den valda planens högsta batchstorlek. Förfrågningskvot och antal förfrågningar per minut är olika gränser. REST-, SDK- och MCP-åtkomst delar samma licensbaserade förfrågningsräkning.
Vid HTTP 429 ska du följa Retry-After och undvika en våg av omedelbara återförsök. Använd ett begränsat antal återförsök med ökande fördröjning vid tillfälliga fel; försök inte om autentiseringsfel eller ogiltiga parametrar hur länge som helst. Förnyelser och planändringar uppdaterar den licensierade kvoten; den återställs inte den första dagen i kalendermånaden.
Testa osäkra situationer före lansering
Testa en känd tjänst, ett okänt ID, en saknad nyckel, ogiltiga parametrar samt en inaktuell eller saknad observation. Kontrollera att dessa situationer ger användbara meddelanden i gränssnittet. Undvik att spara fullständiga diagnostikresultat i offentliga loggar om de innehåller inloggningsuppgifter eller kontoinformation.
API-dokumentationen innehåller alla sju offentliga metoder och OpenAPI-schemat. jsonscraper länkar till SDK:er för Python, Node.js, PHP, Go, Java och .NET. Ett klientbibliotek förenklar transporten, men applikationen behöver fortfarande en policy för hur osäkerhet ska tolkas.
Innehållet granskades den 18 november 2026.
Markdown


