REST / MCP / SDK
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.
Kom igång
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/servicesSök i tjänstekatalogen och bläddra bland resultaten med sidindelning.GET /v1/statusLäs den senast sparade statusen för en tjänst.GET /v1/statusesLäs status för flera tjänster i en förfrågan.GET /v1/summarySammanfatta observerade signaler för en region eller valda tjänster.GET /v1/historyLäs sparade observationer över tid med sidindelning.GET /v1/statsBeräkna andelar av sparade signalurval i stället för uppmätt drifttid.GET /v1/incidentsVisa 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.
Alla tjänsterLicens 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.
Betalningar, förnyelser, planändringar och licenshantering sköts av Evelode.com. Användningsgränsen för förfrågningar återställs när licensen förnyas eller planen ändras. Den återställs inte i början av en kalendermånad. Årsplaner omfattar tolv månadsvisa användningsgränser som samlas i en gemensam pott för hela licensperioden. Historiken byggs upp från det att insamlingen startar. Gratisplanen har ingen återkommande avgift.
PriserAnslut en AI-assistent
Lägg till serveradressen i din assistent, välj OAuth och logga in med Evelode eller ange din licensnyckel på anslutningssidan. Ingen klienthemlighet behövs.
https://mcp.uptimescout.com Authorization: Bearer YOUR_EVELODE_LICENSE_KEY
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.
Exempel på sparade observationer
{
"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.646890Z",
"region": "US",
"service": {
"age_seconds": 16,
"category": "it",
"description": "Plattform f\u00f6r Git-repositorier, kodsamarbete, \u00e4renden och programvaruleverans.",
"description_language": "sv",
"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"
}