Kun ulkoinen alusta lakkaa vastaamasta, siitä tulee nopeasti sinun ongelmasi: kirjautuminen ei onnistu, integraatio jumittuu ja tukipyyntöjono kasvaa. Sama palvelu voi kuitenkin näyttää erilaiselta eri maissa oleville käyttäjille. Yleinen tila ”kaikki toimii” ei tällaisessa tilanteessa riitä.
Julkaisemme jsonscraperin UptimeScout API:n. Se tarjoaa sovelluksillesi ja tekoälyavustajillesi alueellisia signaaleja ulkoisten palveluiden saatavuudesta — mukana historia, havaintoaika ja selkeä tieto datan tuoreudesta. REST, MCP ja kuuden ohjelmointikielen SDK:t ovat jo saatavilla. Voit aloittaa ilmaisella tilauksella.
Tarkastele palvelua haluamastasi maasta
Tukitiimille tärkeä kysymys on yksinkertainen: mitä palvelulle kuuluu siellä, missä käyttäjä on? UptimeScoutin avulla voit valita maan, saada nykyisen signaalin ja verrata sitä muiden alueiden havaintoihin.
Voit esimerkiksi tarkistaa GitHubin tilanteen Venäjällä ja Saksassa ja avata sen jälkeen saatavilla olevan ajanjakson historian. Tämä tuo kontekstia omiin lokeihisi ja auttaa valitsemaan seuraavan tutkintavaiheen. 19. marraskuuta 2026 tarkistetussa API-vastauksessa oli saatavilla 72 aluetta. Tarkista nykyinen kattavuus kentästä available_regions: se voi vaihdella palveluittain.
Jokainen vastaus sisältää havaintoajan observed_at ja vanhentuneisuutta ilmaisevan kentän stale. Kuvausten kieli valitaan maasta erillään: voit pyytää Japania koskevia havaintoja venäjän- tai englanninkielisin kuvauksin. Kuvauskieliä tuetaan yhteensä 20.
Alueellinen signaali auttaa havaitsemaan ongelman. Se ei selvitä ongelman syytä eikä vahvista maailmanlaajuista häiriötä. Yhdistä se omiin tarkistuksiisi ja palveluntarjoajan viralliseen tilaan ongelmaa tutkiessasi; havaintotilastot eivät mittaa käytettävyyttä tai SLA-tasoa.
Avaa havaintokartta
Valitse maa tai etsi haluamasi palvelu. Vaihda maapallon ja kartan välillä nähdäksesi alueelliset erot ja viimeisimpien havaintojen ajat.
Kartta näyttää tallennetun datakuvan, joka päivittyy taustalla noin minuutin välein. Havaintoaika pysyy näkyvissä: jos tuoreita tietoja ei ole, tilaa ei voi pitää vahvistettuna.
Ulkoisesta signaalista hyödylliseksi toiminnaksi
Lisää UptimeScout osaksi tiimisi nykyistä työnkulkua. Koontinäytössä se tuo kontekstia ulkoisiin riippuvuuksiin. Tukitiimissä se auttaa tarkistamaan tietyssä maassa tehdyn ilmoituksen. Automaatiossa se toimii oman raportin tai ilmoituksen tietolähteenä.

- Valitse konteksti
Tarvittava palvelu ja yleisösi maa.
- Tarkista havainto
Tila, aika ja datan tuoreus yhdessä vastauksessa.
- Hyödynnä tulosta
Koontinäytössä, tuessa tai tekoälyavustajassa.
Käytä eräpyyntöä, kun tarkistat useita riippuvuuksia. Vertaa maita tekemällä erillinen pyyntö kullekin alueelle. Tarkista signaali lisälähteistä ennen huolestuttavan ilmoituksen lähettämistä käyttäjille.
Yksi API kolmeen tehtävään
Etsi palvelu
/v1/services — luettelohaku. Aloita tästä ja valitse tarvittava riippuvuus.
Selvitä nykytilanne
/v1/status palauttaa yhden palvelun signaalin, /v1/statuses usean palvelun signaalit kerralla ja /v1/summary kokoaa yhteenvedon.
Tarkastele muutoksia
/v1/history tarjoaa historian, /v1/stats havaintotilastot ja /v1/incidents tuoreimmat kohonneet ongelmasignaalit.
Kaikki seitsemän menetelmää ovat käytettävissä myös MCP:n kautta, esimerkiksi uptimescout_status ja uptimescout_history. Täydet parametrit löytyvät OpenAPI-määrityksestä.
Ensimmäinen pyyntö muutamassa minuutissa
Valitse ilmainen tilaus, hanki lisenssiavain Eveloden kautta ja tallenna se palvelimelle muuttujaan UPTIMESCOUT_LICENSE_KEY. Sama avain käy REST-rajapintaan, MCP:hen ja kaikkiin UptimeScout SDK:ihin.
curl --get 'https://api.uptimescout.com/v1/status' \
--header "Authorization: Bearer $UPTIMESCOUT_LICENSE_KEY" \
--data-urlencode 'service=github' \
--data-urlencode 'region=RU' \
--data-urlencode 'lang=ru'Jos käytät Pythonia, asenna valmis asiakasohjelma GitHub-julkaisusta:
python -m pip install "git+https://github.com/jsonscraper/[email protected]"import os
from uptimescout import Client
client = Client(os.environ["UPTIMESCOUT_LICENSE_KEY"], timeout=30)
response = client.status("github", region="RU", lang="ru")
service = response["service"]
print(service["status"], service["observed_at"], service["stale"])Pythonin lisäksi SDK:t ovat saatavilla Node.js:lle, PHP:lle, Golle, Javalle ja .NETille. Jokaisessa repositoriossa on ohjeet ja esimerkkipyyntöjä.
Käsittele vastauksen kahta kenttää erillisinä: ylätason status kuvaa API-pyynnön suorittamista ja service.status valitun palvelun signaalia. Ota tulosta arvioidessasi huomioon maa, havaintoaika ja stale.
Mitä vastauksessa tulee
Alla on lyhennetty todellinen UptimeScout-vastaus GitHubille Venäjällä, saatu 19. marraskuuta 2026. Tämä on esimerkki tietorakenteesta, ei palvelun tämänhetkinen tila; lisenssi- ja kiintiönkulutuskentät on jätetty pois.
{
"status": "ok",
"region": "RU",
"service": {
"id": "github",
"name": "GitHub",
"status": "operational",
"stale": false,
"observed_at": "2026-11-19T13:46:49.188257Z",
"signal": "reported_availability",
"scope": "regional"
},
"generated_at": "2026-11-19T13:48:48.782598Z",
"stale_after_seconds": 600
}service.status- Valitun palvelun signaali; tässä operational.
region- Havaintomaa, ei vastauksen kieli.
observed_at- Havainnon ajankohta UTC-aikana.
stale- Ilmaisee, onko havainto jo vanhentunut.
generated_at-kenttä kertoo vastauksen muodostamisajan. Se ei korvaa observed_at-kenttää: tiedot voivat olla vastausta vanhempia.
Sama API — keskustelussa avustajan kanssa
Jos haluat aloittaa ilman omaa koodia, yhdistä https://mcp.uptimescout.com yhteensopivaan tekoälyasiakasohjelmaan. MCP-ohjeissa kerrotaan Eveloden tai lisenssiavaimen kautta tehtävästä tunnistautumisesta. Saatavilla on myös jsonscraperin yleinen yhdistin.
”Tarkista GitHub Venäjällä ja Saksassa. Kerro kunkin maan havaintoaika ja datan tuoreus. Jos signaalit eroavat, selitä, mitä tiedetään ja mitä tarkistuksia kannattaa tehdä seuraavaksi.”
Avustaja saa API:lta rakenteiset tiedot ja voi selittää tuloksen tehtäväsi yhteydessä. Tuoreuteen ja alueelliseen kattavuuteen liittyvät rajoitukset ovat silti voimassa.
Kolme tapaa liittää samat tiedot
Valitse tuttu käyttöliittymä. REST sopii suoriin HTTP-pyyntöihin, SDK sovellukseen ja MCP AI-avustajalle. Alue, havainnon tuoreus ja tilojen merkitykset pysyvät kaikissa tapauksissa samoina.
- RESTSuorat HTTP-pyynnöt
- SDKValmis asiakasohjelma sovellukseen
- MCPAI-avustajan työkalut
Aloita ilmaiseksi selkein rajoituksin
Free-tilaus sisältää 1 000 onnistunutta pyyntöä lisenssijaksoa kohden, enintään 60 pyyntöä minuutissa, enintään 5 palvelua yhdessä eräpyynnössä ja 7 päivän historian. RESTiä, SDK:ita ja MCP:tä voi kokeilla samalla lisenssillä.
Onnistunut eräpyyntö kuluttaa yhden pyynnön tilauksen rajoissa. Jokainen historian seuraava sivu lasketaan erilliseksi kutsuksi. Kiintiö liittyy lisenssijaksoon ja nollautuu lisenssin uusimisen tai tilauksen vaihtamisen yhteydessä — ei kuukauden ensimmäisenä päivänä. Historia sisältää vain ajanjaksot, joilta havaintoja on todella kerätty.
Tämä riittää API:hin tutustumiseen ja prototyypin rakentamiseen. Jos käytät API:a jatkuvaan valvontaan, suhteuta pyyntötiheys kiintiöön. Suurempiin kuormiin ovat tarjolla Starter, Builder, Pro ja Scale. Voimassa olevat ehdot on julkaistu tilaussivulla.
Aloita yhdestä riippuvuudesta
Valitse tuotteellesi tärkeä palvelu ja maa, jossa yleisösi on. Katso karttaa, tee ensimmäinen pyyntö ja arvioi, miten alueellinen konteksti auttaa tiimiäsi. Lisää sitten historia, muita riippuvuuksia tai oma tekoälyavustajasi.
