uptimescout
Få en API-nøkkel

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 tjenester

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.

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.

Priser

Koble 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.

Koble til UptimeScout

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"
}

Hurtigvisning

Laster inn lagrede observasjoner

Signaler over tid

Hvert intervall viser signalet som forekommer oftest blant observasjonene. Ved likt antall brukes den sist observerte av tilstandene med like mange. Velg en kolonne for å se hele fordelingen.