# Címkék végpontjai

> A REST API v2 címkevégpontjai: címkék kezelése, a címkéhez tartozó webhelyek és ügyfelek, kötegelt művelet.

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

```bash
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"
```

```json
{
  "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.

```bash
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"
```

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

## Kapcsolódó fejezetek

- [REST API áttekintés](https://hub.hellowp.io/hu/plugins/mainwp/rest-api-attekintes/)
- [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/)
- [Kötegelt műveletek](https://hub.hellowp.io/hu/plugins/mainwp/rest-api-kotegelt-muveletek/)