REST / MCP / SDK
UptimeScout API-dokumentasjon
Tjenestestatus, regionale signaler og historikk via REST, SDK-er og MCP. Bygg dashbord og gi AI-assistenter tydelig kontekst om tilgjengelighet.
Hurtigstart
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/servicesSøk i tjenestekatalogen og bla gjennom resultatene side for side.GET /v1/statusLes den gjeldende lagrede statusen for én tjeneste.GET /v1/statusesLes status for flere tjenester i én forespørsel.GET /v1/summaryOppsummer observerte signaler for en region eller utvalgte tjenester.GET /v1/historyLes lagrede observasjoner over tid, med paginering.GET /v1/statsBeregn forholdstall for lagrede signalutvalg, ikke målt oppetid.GET /v1/incidentsVis 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.
Alle tjenesterLisens 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.
Betalinger, fornyelser, planendringer og lisensadministrasjon håndteres av Evelode.com. Forespørselskvoten nullstilles når lisensen fornyes eller planen endres. Den nullstilles ikke ved starten av en kalendermåned. Årsplaner inkluderer tolv månedskvoter samlet i én forespørselspott for hele lisensperioden. Historikken bygges opp fra innsamlingen starter. Gratis-abonnementet har ingen løpende kostnader.
PriserKoble til en AI-assistent
Legg til serveradressen i assistenten, velg OAuth og logg inn med Evelode eller skriv inn lisensnøkkelen på tilkoblingssiden. Ingen klienthemmelighet er nødvendig.
https://mcp.uptimescout.com Authorization: Bearer YOUR_EVELODE_LICENSE_KEY
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.
Eksempel basert på lagrede observasjoner
{
"available_regions": [
"AE",
"AR",
"AT",
"AU",
"AZ",
"BD",
"BE",
"BG",
"BH",
"BR",
"CA",
"CH",
"CL",
"CO",
"CR",
"CZ",
"DE",
"DK",
"DO",
"DZ",
"EC",
"EG",
"ES",
"FI",
"FR",
"GB",
"GR",
"GT",
"HK",
"HR",
"HU",
"ID",
"IE",
"IL",
"IN",
"IT",
"JO",
"JP",
"KE",
"KR",
"MA",
"MX",
"MY",
"NG",
"NL",
"NO",
"NZ",
"PA",
"PE",
"PH",
"PK",
"PL",
"PR",
"PT",
"PY",
"RO",
"RS",
"RU",
"SA",
"SE",
"SG",
"SK",
"TH",
"TN",
"TR",
"TW",
"UA",
"US",
"UY",
"VE",
"VN",
"ZA"
],
"data_type": "availability_observations",
"generated_at": "2026-11-18T18:55:18.100387Z",
"region": "US",
"service": {
"age_seconds": 16,
"category": "it",
"description": "Plattform for Git-repositorier, kodesamarbeid, saker og programvareleveranser.",
"description_language": "no",
"id": "github",
"logo_kind": "brand",
"logo_url": "https://uptimescout.com/static/brand-assets/github.svg?v=18e8fe76f953a31c",
"name": "GitHub",
"observed_at": "2026-11-18T18:55:01.987427Z",
"regions": [
"US"
],
"scope": "regional",
"signal": "reported_availability",
"stale": false,
"status": "outage"
},
"stale_after_seconds": 600,
"status": "ok"
}