REST / MCP / SDK
UptimeScout API -dokumentaatio
Palvelujen tilat, alueelliset havainnot ja historia REST-, SDK- ja MCP-yhteyksien kautta. Rakenna hallintapaneeleja ja anna tekoälyavustajille selkeä kuva palvelujen saatavuudesta.
Pika-aloitus
curl -G https://api.uptimescout.com/v1/status \ --data-urlencode "service=github" \ --data-urlencode "region=US" \ -H "Authorization: Bearer $EVELODE_LICENSE_KEY"
Käytettävissä olevat metodit
GET /v1/servicesHae palveluluetteloa ja selaa sitä sivu kerrallaan.GET /v1/statusLue yhden palvelun nykyinen tallennettu tila.GET /v1/statusesLue useiden palvelujen tilat yhdellä pyynnöllä.GET /v1/summaryTee yhteenveto alueen tai valittujen palvelujen havaituista signaaleista.GET /v1/historyLue tallennettuja havaintoja eri ajankohdilta ja selaa niitä sivu kerrallaan.GET /v1/statsLaske tallennettujen signaaliotosten suhteet mitatun käytettävyyden sijaan.GET /v1/incidentsLuettele palvelut, joilla on kohonneita häiriösignaaleja; kyse ei ole vahvistetuista maailmanlaajuisista häiriöistä.Miten tiedot toimivat
UptimeScout tallentaa alueellisia havaintoja taustalla. Jokainen vastaus sisältää havaintoajan ja tiedot tietojen tuoreudesta. Samasta palvelusta voi olla eri alueilla erilaisia signaaleja.
Toimintaa kuvaava signaali tarkoittaa, ettei tallennetussa otoksessa havaittu tavallista suurempia häiriöitä. Kohonneita häiriösignaaleja kuvaavat havainnot kertovat havaituista olosuhteista, eivät vahvistetusta maailmanlaajuisesta häiriöstä. Puuttuvat tai vanhentuneet havainnot ovat tuntemattomia. Otosten suhteet eivät ole mitattuja käytettävyysprosentteja eivätkä palvelutasosopimuksen (SLA) mukaisia mittaustuloksia.
Käyttöliittymä päivittyy minuutin välein. Arvioi tietojen ajantasaisuutta tarkistamalla kunkin palvelun havaintoaika ja tuoreus.
Kieli määrittää, miten tiedot esitetään; havaintoalue määrittää, mitä maata tiedot kuvaavat. Voit vaihtaa niitä toisistaan riippumatta. Käännetty sivu ei automaattisesti tarkoita, että havainnot olisivat peräisin tietystä maasta.
Kaikki palvelutLisenssi ja pyyntörajat
Käytä Evelode-lisenssiavaintasi Bearer-tunnisteena. Säilytä se palvelimellasi, äläkä lisää sitä selainkoodiin tai julkisiin koodivarastoihin. Kiintiö vähenee vain onnistuneista lisensoiduista datapyynnöistä. Lisenssin uusiminen tai sen paketin vaihtaminen aloittaa uuden kiintiön; kalenterikuukaudet eivät nollaa sitä. Vuositilauksen pyyntökiintiö on 12 kertaa yhden kuukausittaisen lisenssijakson pyyntökiintiö.
Maksut, uusinnat, tilausten muutokset ja lisenssien hallinta hoidetaan Evelode.comissa. Pyyntökiintiö nollautuu, kun lisenssi uusitaan tai sen tilausta muutetaan. Se ei nollaudu kalenterikuukauden alussa. Vuositilauksen pyyntökiintiö on 12 kertaa yhden kuukausittaisen lisenssijakson pyyntökiintiö. Historiatiedot kertyvät seurannan käynnistämisestä alkaen. Maksuttomasta tilauksesta ei veloiteta toistuvaa maksua.
HinnatYhdistä tekoälyavustaja
Lisää palvelimen osoite avustajaan, valitse OAuth ja kirjaudu Evelodella tai syötä lisenssiavain yhdistämissivulla. Asiakassalaisuutta ei tarvita.
https://mcp.uptimescout.com Authorization: Bearer YOUR_EVELODE_LICENSE_KEY
Vastausten käsittely
Tarkista HTTP-tila ennen tietojen lukemista: 400 tarkoittaa virheellisiä parametreja, 401 tai 403 liittyy tunnistautumis- tai lisenssiongelmaan, 409 tarkoittaa lisenssioikeuden muuttuneen pyynnön aikana, 429 ilmaisee pyyntö- tai nopeusrajan ylittymistä ja 503 tilapäistä käytöstä poissaoloa. Noudata uudelleenyritysviiveitä ja vältä tiheää uudelleenyritystä.
Esimerkki tallennetuista havainnoista
{
"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:17.253466Z",
"region": "US",
"service": {
"age_seconds": 15,
"category": "it",
"description": "Alusta Git-tietovarastoille, koodin yhteiskehitykselle, ongelmien seurannalle ja ohjelmistojen julkaisemiselle.",
"description_language": "fi",
"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"
}