# API: entitások, szabad időpontok és statisztika

> Több entitástípus lekérése egyetlen kéréssel, a szabad időpontok lekérdezése és a vezérlőpult statisztikái az API-val.

Ez a fejezet három lekérdező végpontot ír le: az entitások egyben történő lekérését, a szabad időpontok (idősávok) lekérdezését és a statisztikák lekérését.

Az API az Elite licenchez tartozik, használatához programozási ismeret kell, a szokásos támogatás nem terjed ki rá. A hitelesítés az **Amelia** fejlécben küldött API-kulccsal történik ([részletek](https://hub.hellowp.io/hu/plugins/ameliabooking/fejlesztoknek-api-attekintes/)). Az alap útvonal: `{{az_oldalad_URL-je}}/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1`.

| Művelet | Metódus | Útvonal |
|---|---|---|
| Entitások lekérése | `GET` | `/entities` |
| Szabad időpontok lekérése | `GET` | `/slots` |
| Statisztikák lekérése | `GET` | `/stats` |

## Entitások lekérése

Az entitások végpontja egyetlen kéréssel adja vissza több entitástípus (például események, helyszínek, szolgáltatások és a beállítások) strukturált adatait. A `types` lekérdezési paraméterben vesszővel elválasztva sorold fel, melyeket kérsz.

A `types` lehetséges értékei: `employees`, `categories`, `locations`, `packages`, `entitiesRelations`, `customFields`, `customers`, `services`, `coupons`, `events`, `tags`, `appointments`, `settings`, `resources`, `lessonSpace_spaces`, `taxes`.

```bash
curl --location 'https://pelda.hu/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1/entities&types=locations,events' \
--header 'Amelia: AZ_API_KULCSOD'
```

## Szabad időpontok lekérése

A `GET /slots` egy szolgáltatásra adja vissza a foglalható idősávokat az időtartam, a létszám és az opcionális szűrők (munkavállalók, helyszín, extrák, átütemezési szabályok) alapján.

**Kötelező paraméterek**

| Paraméter | Típus | Leírás |
|---|---|---|
| `serviceId` | egész | A szolgáltatás azonosítója. |
| `persons` | egész | A létszám. |

**Opcionális paraméterek**

| Paraméter | Típus | Leírás |
|---|---|---|
| `providerIds` | tömb | Munkavállalóazonosítók. |
| `locationId` | egész | A helyszín azonosítója. |
| `serviceDuration` | egész | A szolgáltatás időtartama másodpercben. |
| `startDateTime` | szöveg | Ettől az időponttól kéri az idősávokat, `ÉÉÉÉ-HH-NN ÓÓ:PP` formában. |
| `endDateTime` | szöveg | Eddig az időpontig kéri az idősávokat, ugyanebben a formában. |
| `excludeAppointmentId` | egész | Az itt megadott időpontot nem veszi figyelembe a számításnál; átütemezéskor használd. |
| `extras` | tömb | Az extrák, mert hatással lehetnek az idősávokra. |

```bash
curl --location 'https://pelda.hu/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1/slots&locationId=2&serviceId=3&serviceDuration=1800&providerIds=3&persons=1&startDateTime=2026-02-10%2008:00&endDateTime=2026-02-12%2018:00' \
--header 'Amelia: AZ_API_KULCSOD'
```

## Statisztikák lekérése

A `GET /stats` a vezérlőpult statisztikáit adja vissza munkavállalókra, szolgáltatásokra, helyszínekre, vásárlókra és időpontokra, a kiválasztott időszakban.

| Paraméter | Típus | Leírás |
|---|---|---|
| `dates` | szöveg | Opcionális. Kezdő és záró dátum `kezdet,vég` formában, például `2026-05-18,2026-05-19`. |

```bash
curl --location 'https://pelda.hu/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1/stats&dates=2026-05-18%2C2026-05-19' \
--header 'Amelia: AZ_API_KULCSOD'
```