Kötegelt műveletek

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

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"

{
  "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
• Ügyfelek és költségek végpontjai
• REST API áttekintés