uptimescout
Hanki API-avain

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 palvelut

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

Hinnat

Yhdistä tekoälyavustaja

Lisää palvelimen osoite avustajaan, valitse OAuth ja kirjaudu Evelodella tai syötä lisenssiavain yhdistämissivulla. Asiakassalaisuutta ei tarvita.

Yhdistä UptimeScout

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

Pikakatselu

Ladataan tallennettuja havaintoja

Tilanne ajan mittaan

Kukin aikaväli näyttää useimmin havaitun signaalin. Tasatilanteessa ratkaisee tasoissa olevista tiloista viimeisin. Valitse sarake nähdäksesi tarkemman erittelyn.