uptimescout
Skaffa en API-nyckel

UptimeScout-guide

Så integrerar du ett API för tjänstetillgänglighet med UptimeScout

Skapa en tillgänglighetspanel där tidsstämplar och osäkerhet förblir synliga i stället för att reducera varje svar till en färgad punkt.

Fiber- och nätverkskontakter i en serverpanel.
AI-genererad redaktionell illustration

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

REST / MCP / SDK

Kontrollera en tjänst eller integrera API:et

Använd tjänstekatalogen för en aktuell regional signal och dokumentationen för en reproducerbar integration.

TjänstekatalogAPI-dokumentation