# UptimeScouts API-dokumentation

Tjänstestatus, regionala signaler och historik via REST, SDK:er och MCP. Skapa dashboards och ge AI-assistenter tydlig information om tillgänglighet.

URL: https://uptimescout.com/sv/docs/

## REST

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

## Tillgängliga metoder

- `GET /v1/services`: Sök i tjänstekatalogen och bläddra bland resultaten med sidindelning.

- `GET /v1/status`: Läs den senast sparade statusen för en tjänst.

- `GET /v1/statuses`: Läs status för flera tjänster i en förfrågan.

- `GET /v1/summary`: Sammanfatta observerade signaler för en region eller valda tjänster.

- `GET /v1/history`: Läs sparade observationer över tid med sidindelning.

- `GET /v1/stats`: Beräkna andelar av sparade signalurval i stället för uppmätt drifttid.

- `GET /v1/incidents`: Visa tjänster med förhöjda signaler. Det här är inte bekräftade globala incidenter.

## Så fungerar data

UptimeScout lagrar regionala observationer i bakgrunden. Varje svar innehåller en observationstid och information om hur aktuell informationen är. Samma tjänst kan ha olika signaler i olika regioner.

En signal om normal drift innebär att ingen förhöjd störning observerades i det sparade urvalet. Förhöjda signaler eller störningssignaler beskriver observerade förhållanden, inte en bekräftad global incident. Saknade eller inaktuella observationer har okänd status. Andelar i urvalet är inte uppmätta drifttidsprocent och utgör ingen SLA.

Insamlingen pågår kontinuerligt i olika regioner. Kontrollera varje tjänsts observationstidpunkt och aktualitet för att bedöma hur aktuell statusen är.

Språket styr hur informationen presenteras, medan observationsregionen styr vilket land informationen gäller. Du kan ändra dem oberoende av varandra. En översatt sida innebär inte automatiskt att observationerna kommer från ett visst land.

## Licens och förfrågningsgränser

Använd din Evelode-licensnyckel som en Bearer-token. Förvara den på din server, inte i webbläsarkod eller offentliga kodarkiv. Endast lyckade dataförfrågningar med giltig licens räknas av från tilldelningen. När du förnyar licensen eller byter plan får du en ny tilldelning; den återställs inte vid månadsskiften. Årsplaner har en gemensam förfrågningspott för hela licensperioden på ett år.

## Anslut en AI-assistent

Anslut en Streamable HTTP MCP-klient till slutpunkten nedan och ange din licensnyckel i Authorization-headern. Sju skrivskyddade verktyg visar tjänstestatus, regionala signaler och historik. Samma licensbegränsningar gäller.

https://mcp.uptimescout.com

## Hantera svar

Kontrollera HTTP-statusen innan du läser data: 400 betyder ogiltiga parametrar, 401 eller 403 anger ett problem med autentisering eller licens, 409 betyder att licensens åtkomstbehörighet ändrades under begäran, 429 anger en förfrågnings- eller hastighetsgräns och 503 betyder tillfällig otillgänglighet. Respektera väntetiderna före återförsök och undvik täta återförsök.

OpenAPI: https://uptimescout.com/openapi.json
