# UptimeScout API-dokumentasjon

Tjenestestatus, regionale signaler og historikk via REST, SDK-er og MCP. Bygg dashbord og gi AI-assistenter tydelig kontekst om tilgjengelighet.

URL: https://uptimescout.com/no/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"
```

## Tilgjengelige metoder

- `GET /v1/services`: Søk i tjenestekatalogen og bla gjennom resultatene side for side.

- `GET /v1/status`: Les den gjeldende lagrede statusen for én tjeneste.

- `GET /v1/statuses`: Les status for flere tjenester i én forespørsel.

- `GET /v1/summary`: Oppsummer observerte signaler for en region eller utvalgte tjenester.

- `GET /v1/history`: Les lagrede observasjoner over tid, med paginering.

- `GET /v1/stats`: Beregn forholdstall for lagrede signalutvalg, ikke målt oppetid.

- `GET /v1/incidents`: Vis tjenester med forhøyede signaler. Dette er ikke bekreftede globale hendelser.

## Slik fungerer dataene

UptimeScout lagrer regionale observasjoner i bakgrunnen. Hvert svar inneholder et observasjonstidspunkt og informasjon om hvor ferske dataene er. Den samme tjenesten kan ha ulike signaler i forskjellige regioner.

Et operativt signal betyr at det ikke ble observert forhøyede forstyrrelser i det lagrede utvalget. Signaler om forhøyede forstyrrelser eller avbrudd beskriver observerte forhold, ikke en bekreftet global hendelse. Manglende eller utdaterte observasjoner har ukjent status. Andeler i utvalget er ikke målte oppetidsprosenter eller en SLA.

Grensesnittet oppdateres hvert minutt. Sjekk observasjonstidspunktet og hvor fersk statusen er for hver tjeneste, slik at du kan vurdere hvor oppdatert den er.

Språket styrer hvordan informasjonen presenteres, mens observasjonsregionen avgjør hvilket land dataene gjelder. Du kan endre dem uavhengig av hverandre. En oversatt side innebærer ikke automatisk at observasjonene kommer fra et bestemt land.

## Lisens og forespørselsgrenser

Bruk Evelode-lisensnøkkelen din som et Bearer-token. Oppbevar den på serveren, utenfor nettleserkode og offentlige kodearkiver. Bare vellykkede, lisensierte dataforespørsler belastes kvoten. Når du fornyer en lisens eller endrer planen, får du en ny kvote. Kvoten nullstilles ikke hver kalendermåned. Årsplaner gir én samlet forespørselskvote for hele lisensperioden på ett år.

## Koble til en AI-assistent

Koble en Streamable HTTP MCP-klient til endepunktet nedenfor, og oppgi lisensnøkkelen din i Authorization-headeren. Sju skrivebeskyttede verktøy gir tjenestestatus, regionale signaler og historikk. De samme lisensbegrensningene gjelder.

https://mcp.uptimescout.com

## Håndtering av svar

Kontroller HTTP-statusen før du leser dataene: 400 betyr ugyldige parametere, 401 eller 403 viser til et autentiserings- eller lisensproblem, 409 betyr at lisensrettighetene ble endret under forespørselen, 429 viser til en forespørsels- eller hastighetsgrense, og 503 betyr midlertidig utilgjengelighet. Følg ventetidene før nye forsøk, og unngå gjentatte forsøk med svært korte mellomrom.

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