MagyarmagyarAPI: 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). 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
Szekció neve “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.
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
Szekció neve “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. |
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
Szekció neve “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. |
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'Készült: