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

URL: https://uptimescout.com/fi/docs/

## REST

```sh
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/services`: Hae palveluluetteloa ja selaa sitä sivu kerrallaan.

- `GET /v1/status`: Lue yhden palvelun nykyinen tallennettu tila.

- `GET /v1/statuses`: Lue useiden palvelujen tilat yhdellä pyynnöllä.

- `GET /v1/summary`: Tee yhteenveto alueen tai valittujen palvelujen havaituista signaaleista.

- `GET /v1/history`: Lue tallennettuja havaintoja eri ajankohdilta ja selaa niitä sivu kerrallaan.

- `GET /v1/stats`: Laske tallennettujen signaaliotosten suhteet mitatun käytettävyyden sijaan.

- `GET /v1/incidents`: Luettele 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.

## 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ö.

## Yhdistä tekoälyavustaja

Yhdistä alla olevaan päätepisteeseen Streamable HTTP MCP -asiakasohjelmalla ja anna lisenssiavaimesi Authorization-otsakkeessa. Seitsemän vain luku -työkalua tarjoaa palvelujen tilat, alueelliset havainnot ja historian. Samat lisenssirajoitukset ovat voimassa.

https://mcp.uptimescout.com

## 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ä.

OpenAPI: https://uptimescout.com/openapi.json
