Címkék végpontjai

A címkék (Tags) a webhelyek csoportjai. Ezekkel a végpontokkal létrehozhatod, módosíthatod és törölheted őket, lekérdezheted a címkéhez tartozó webhelyeket és ügyfeleket, és egyetlen kéréssel több címkét is kezelhetsz. A pontos kérés- és válaszszerkezetet a Postman-gyűjtemény tartalmazza.

Végpontok

Metódus	Útvonal	Mire jó	Fő paraméterek
GET	/tags	Címkék listázása	page, per_page, search, include, exclude
GET	/tags/{id}	Egy címke adatai	id
POST	/tags/add	Címke létrehozása	name, opcionálisan color
POST, PUT, PATCH	/tags/{id}/edit	Címke szerkesztése	name, opcionálisan color
DELETE	/tags/{id}/remove	Címke törlése	id
GET	/tags/{id}/sites	A címkéhez tartozó webhelyek	id
GET	/tags/{id}/clients	A címkézett webhelyeken keresztül kapcsolódó ügyfelek	id
POST	/tags/batch	Kötegelt létrehozás, módosítás, törlés	create[], update[], delete[]

Példák

Címke létrehozása

curl -X POST \
  -H "Authorization: Bearer API_KULCS" \
  -H "Content-Type: application/json" \
  -d '{"name":"Éles","color":"#7fb100"}' \
  "https://a-te-vezerlopultod.hu/wp-json/mainwp/v2/tags/add"

{
  "success": 1,
  "message": "Tag created successfully.",
  "data": {
    "id": 7,
    "name": "Éles"
  }
}

Címkék kötegelt kezelése

Egy kérésben létrehozhatsz, módosíthatsz és törölhetsz címkéket. A create elemei új címkék, az update elemei az id mezővel azonosítják a módosítandó címkét, a delete pedig a törlendő címkék azonosítóit tartalmazza.

curl -X POST \
  -H "Authorization: Bearer API_KULCS" \
  -H "Content-Type: application/json" \
  -d '{
    "create": [{"name":"VIP"}],
    "update": [{"id":7,"name":"Éles webhelyek"}],
    "delete": [11]
  }' \
  "https://a-te-vezerlopultod.hu/wp-json/mainwp/v2/tags/batch"

{
  "create": [{"success": 1}],
  "update": [{"success": 1}],
  "delete": [{"success": 1}]
}

Kapcsolódó fejezetek

• REST API áttekintés
• Webhelyek végpontjai
• Ügyfelek és költségek végpontjai
• Kötegelt műveletek