# Monitorok végpontjai

> A REST API v2 rendelkezésre állást figyelő végpontjai: monitorlista, szívverés, események, azonnali ellenőrzés és monitorbeállítások.

A monitorvégpontokkal a rendelkezésre állás figyelésének (uptime) adatait olvashatod, és a monitorok beállításait módosíthatod. A `{id_or_domain}` a webhely számazonosítóját vagy domainjét fogadja el. A pontos kérés- és válaszszerkezetet a Postman-gyűjtemény és az OpenAPI-leírás adja.

## Monitorlisták

| Metódus | Útvonal | Mire jó | Fő paraméterek |
|---|---|---|---|
| GET | `/monitors` | Monitorok teljes mérőszámokkal | `status`, `search`, `include`, `exclude`, `page`, `per_page` |
| GET | `/monitors/basic` | Monitorok alap mezőkkel | `status`, `search`, `include`, `exclude`, `page`, `per_page` |
| GET | `/monitors/count` | Monitorok száma | `status`, `search`, `include`, `exclude` |

## Monitoronkénti adatok

| Metódus | Útvonal | Mire jó | Fő paraméterek |
|---|---|---|---|
| GET | `/monitors/{id_or_domain}` | A monitor részletei | |
| GET | `/monitors/{id_or_domain}/basic` | A monitor alap adatai | |
| GET | `/monitors/{id_or_domain}/heartbeat` | Szívverés-előzmények | `period`, `since`, `limit`, `status`, `page` |
| GET | `/monitors/{id_or_domain}/incidents` | Események listája | `page`, `per_page` |
| GET | `/monitors/{id_or_domain}/incidents/count` | Események száma | |
| POST | `/monitors/{id_or_domain}/check` | Azonnali ellenőrzés indítása | |

## Monitorbeállítások

| Metódus | Útvonal | Mire jó | Fő paraméterek |
|---|---|---|---|
| PUT, PATCH | `/monitors/{id_or_domain}/settings` | Egy monitor beállításainak módosítása | `active`, `interval`, `timeout`, `maxretries`, `type`, `method`, `expected_status`, `keyword` |
| PUT, PATCH | `/monitors/settings` | A globális monitoralapértékek módosítása | `active`, `interval`, `timeout`, `maxretries`, `type`, `method`, `expected_status`, `keyword` |

## Példák

### Egy webhely monitoresemények lekérése

```bash
curl -H "Authorization: Bearer API_KULCS" \
  "https://a-te-vezerlopultod.hu/wp-json/mainwp/v2/monitors/12/incidents?page=1&per_page=20"
```

```json
{
  "success": 1,
  "total": 3,
  "data": [
    {
      "status": "down",
      "started_at": "2026-02-01 11:03:00"
    }
  ]
}
```

### Egy monitor beállításainak módosítása

```bash
curl -X PATCH \
  -H "Authorization: Bearer API_KULCS" \
  -H "Content-Type: application/json" \
  -d '{
    "active":"useglobal",
    "interval":"5m",
    "timeout":"30000",
    "type":"http",
    "method":"get"
  }' \
  "https://a-te-vezerlopultod.hu/wp-json/mainwp/v2/monitors/12/settings"
```

```json
{
  "success": 1,
  "message": "Monitor settings updated successfully."
}
```

A figyelés kezelőfelületéről az [Uptime-figyelés](https://hub.hellowp.io/hu/plugins/mainwp/webhelyek-uptime-figyeles/) fejezetben olvashatsz.

## Kapcsolódó fejezetek

- [REST API áttekintés](https://hub.hellowp.io/hu/plugins/mainwp/rest-api-attekintes/)
- [Beállítások végpontjai](https://hub.hellowp.io/hu/plugins/mainwp/rest-api-beallitasok/)
- [Webhelyek végpontjai](https://hub.hellowp.io/hu/plugins/mainwp/rest-api-webhelyek/)