# Kötegelt műveletek

> A globális /batch végpont működése, korlátai és különbsége a vezérlőnkénti kötegelt végpontoktól.

A globális `/batch` végponttal egyetlen kéréssel több vezérlő (webhelyek, ügyfelek, címkék) műveleteit indíthatod el. A pontos kérés- és válaszszerkezetet a Postman-gyűjtemény és az OpenAPI-leírás adja.

## A globális végpont

| Metódus | Útvonal | Mire jó | Fő paraméterek |
|---|---|---|---|
| POST, PUT, PATCH | `/batch` | Csoportosított kötegelt műveletek több vezérlőn át | Vezérlőnkénti objektumok (`sites`, `clients`, `tags`) |

## Működése

A globális `/batch` vezérlése az összehangolásra épül:

- A `sites`, `clients` és `tags` csoporthoz csoportosított `create` (létrehozás) kéréseket fogad.
- A `sites` alatt további webhelyműveleti tömböket is támogat: `sync`, `reconnect`, `disconnect`, `suspend`, `check`, `remove`, `security`, `plugins`, `themes`, `non-mainwp-changes`.
- Elemszámkorlátot érvényesít: a `mainwp_rest_batch_items_limit` alapértéke `100`.

Minden csoport egy objektum legyen, a támogatott műveleti tömbökkel. A `create` elemei objektumok, a további webhelyműveleteknél pozitív webhelyazonosítókat adj meg. Hibás csoport vagy nem támogatott művelet esetén csoportszintű `rest_invalid_param` hibát kapsz, és az a csoport nem fut le. A globális végpont elutasítja az `updates` és `costs` csoportot, valamint az ismeretlen csoportokat `rest_batch_group_not_supported` hibával. Frissítésekhez az Updates végpontokat, költségműveletekhez a `/costs/batch` végpontot használd.

Nézd át a visszaadott csoportokat és az elemenkénti hibákat akkor is, ha az egész kérés HTTP 200-zal tér vissza: az érvényes csoportok egy elutasított csoport mellett is lefuthatnak.

## Példa

```bash
curl -X POST \
  -H "Authorization: Bearer API_KULCS" \
  -H "Content-Type: application/json" \
  -d '{
    "sites": {
      "create": [
        {"url":"https://a-webhely.hu","name":"A webhely","admin":"admin","uniqueid":"xxxxx"}
      ],
      "sync": [12, 19]
    },
    "tags": {
      "create": [
        {"name":"Kezelt"}
      ]
    }
  }' \
  "https://a-te-vezerlopultod.hu/wp-json/mainwp/v2/batch"
```

```json
{
  "sites": {
    "create": [{"success": 1}],
    "sync": [{"success": 1}]
  },
  "tags": {
    "create": [{"success": 1}]
  }
}
```

A webhely létrehozásának tartalmaznia kell azt a kapcsolódási adatot, amelyet a Child-webhely MainWP Child beállítása megkövetel: az `adminpassword` vagy a `uniqueid` mezőt, vagy mindkettőt.

## Globális és vezérlőnkénti kötegelés

A vezérlőnkénti kötegelt végpontokat akkor használd, ha az adott vezérlő saját, CRUD-jellegű kötegelésére van szükséged:

- `/sites/batch`
- `/clients/batch`
- `/tags/batch`
- `/costs/batch`

A globális `/batch` akkor jó, ha egyetlen összehangolt kéréssel több vezérlőtípust kell érintened.

## Kapcsolódó fejezetek

- [Webhelyek végpontjai](https://hub.hellowp.io/hu/plugins/mainwp/rest-api-webhelyek/)
- [Ügyfelek és költségek végpontjai](https://hub.hellowp.io/hu/plugins/mainwp/rest-api-ugyfelek-koltsegek/)
- [REST API áttekintés](https://hub.hellowp.io/hu/plugins/mainwp/rest-api-attekintes/)