# API-valvonta

Source: https://instatus.com/help/fi/monitoring/api

API-monitorit lähettävät määritettävän HTTP-pyynnön päätepisteeseen 30 sekunnin välein ja hälyttävät, kun se ei ole tavoitettavissa, vastaa hitaasti tai palauttaa vääriä tietoja. Voit määrittää metodin, otsakkeet, sisällön ja todennuksen sekä tarkistaa tilakoodin, JSON-sisällön, otsakkeet ja vastausajan.

Kuten [muidenkin monitorien](https://instatus.com/help/fi/monitoring) kohdalla, jos API-monitori havaitsee ongelman, voit ratkaista [häiriön yhdessä tiimisi kanssa](https://instatus.com/help/fi/incident-response) ja halutessasi päivittää [statussivusi](https://instatus.com/help/fi/status-page).

| At a glance | Details |
| :-- | :-- |
| [Tarkistusväli](https://instatus.com/help/fi/monitoring/api#lisäasetukset) | 30 sekunnin välein |
| [HTTP-metodit](https://instatus.com/help/fi/monitoring/api#pyynnön-määritys) | GET, POST, PUT, PATCH, DELETE, OPTIONS, HEAD |
| [Pyynnön sisältö](https://instatus.com/help/fi/monitoring/api#pyynnön-määritys) | JSON, lomaketiedot, GraphQL, pelkkä teksti |
| [Todennus](https://instatus.com/help/fi/monitoring/api#pyynnön-määritys) | Basic auth, API-avain, Bearer-token |
| [Ehdot](https://instatus.com/help/fi/monitoring/api#monitori-onnistuu-jos) | Tilakoodi, vastausaika, sisältö, JSON-polku, otsakkeet |
| [Tarkistussijainnit](https://instatus.com/help/fi/monitoring/api#lisäasetukset) | Yhdysvallat, Kanada, Eurooppa, Aasia |

![Monitori](https://instatus.com/help/monitors/item.png)

## Mitä API-monitori tarkistaa?

- Testaa API-päätepisteesi eri puolilta maailmaa 30 sekunnin välein.
- Validoi HTTP-tilakoodit, JSON-sisältö, otsakkeet ja vastausajat.
- Sisällytä mukautetut otsakkeet, kyselyparametrit tai JSON-hyötykuormat.
- Saat ilmoituksen heti, jos päätepiste on alhaalla, hidas tai palauttaa odottamattomia tuloksia.
- Yhdistä Slackiin, sähköpostiin, tekstiviesteihin, puheluihin, webhookeihin ja muihin.

## Miten lisään API-monitorin?

Siirry projektiisi → Monitorit → Lisää monitori, valitse **API**, syötä päätepisteen URL, määritä pyyntö ja aseta ehdot, joiden täyttyessä päätepiste on kunnossa.

![Lisää API-monitori](https://instatus.com/help/monitors/API.png)

### Monitorin tyyppi

Valitse monitorin tyypiksi **API**.

![API-monitorin tyyppi](https://instatus.com/help/monitors/type-api.png)

Syötä valvottavan päätepisteen URL — esimerkiksi  
`https://api.yourservice.com/v1/users`.

### Pyynnön määritys

Voit räätälöidä API-pyyntösi täysin:

- **HTTP-metodi:** `GET`, `POST`, `PUT`, `PATCH`, `DELETE`, `OPTIONS` tai `HEAD`
- **Sisältö:** Lähetä pyynnön mukana JSON, lomaketiedot, GraphQL tai pelkkä teksti
- **Todennus:** Lisää perustodennus, API-avain tai Bearer-token
- **Kyselyparametrit:** Liitä avain–arvo-pareja pyynnön URL-osoitteeseen
- **Otsakkeet:** Lisää API-pyyntösi vaatimat mukautetut otsakkeet

### Monitori onnistuu, jos

API-monitori onnistuu, kun kaikki määritetyt ehdot täyttyvät.  
Voit asettaa yhden tai useamman seuraavista ehdoista:

- **Tilakoodi:** esim. vastaus on `200 OK`
- **Vastausaika:** esim. alle `1 second`
- **Sisältö sisältää:** esim. `"success": true`
- **JSON-polku:** esim. `data.status` on `"active"`
- **Otsake sisältää:** esim. `Content-Type: application/json`

Jos jokin näistä ehdoista ei täyty, monitori merkitään tilaan **alhaalla** ja hälytykset lähetetään [hälytysasetustesi](https://instatus.com/help/fi/monitoring/alerts) mukaisesti.

### Lisäasetukset

![Monitorin lisäasetukset](https://instatus.com/help/monitors/advanced-settings.png)

- **Kutsumanimi:** Anna monitorillesi kuvaava nimi, jotta tunnistat sen helpommin.
- **Suorita tarkistukset joka:** Päätä, kuinka usein päätepiste testataan.
- **Suorita sijainnista:** Valitse testaussijainnit (Yhdysvallat, Kanada, Eurooppa, Aasia).
- **Lisää statussivulle:** Näytä API:n käyttöaika ja vastaustilastot julkisesti.
- **Kun monitori epäonnistuu:** Luo häiriö, ilmoita tilaajille tai julkaise se statussivullesi.
- **Kun monitori palautuu:** Ratkaise häiriöt ja päivitä statussivusi automaattisesti.

Onnittelut, lisäsit ensimmäisen API-monitorisi!

- [Cron-valvonta](https://instatus.com/help/fi/monitoring/cron): Opi valvomaan ajoitettuja tehtäviä ja taustatöitä