API: keresés és WordPress-felhasználók

Ez a fejezet két lekérdező végpontot ír le. Mindkettő az Elite licenchez tartozó API-t használja, a hitelesítés a hitelesítésről szóló fejezet szerint, az Amelia fejlécben küldött kulccsal történik. Az alap útvonal minden példában: {{az_oldalad_URL-je}}/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1.

Szabad időpontok keresése a keresőűrlaphoz

A végponttal egy adott napra kérhetsz le elérhető szolgáltatásokat és a hozzájuk tartozó elérhetőségi adatokat, ahogy a keresőűrlap folyamata is teszi. Szűrhetsz szolgáltatásra, munkavállalóra, helyszínre és időtartományra, lapozhatsz és rendezhetsz.

• Metódus: GET
• Útvonal: /search

Paraméter	Típus	Kötelező	Leírás
date	szöveg	igen	A keresett nap, ÉÉÉÉ-HH-NN formában.
services	tömb	nem	Szolgáltatásazonosítók.
providers	tömb	nem	Munkavállalói azonosítók.
location	egész	nem	Helyszínazonosító.
timeFrom	szöveg	nem	Ettől az időponttól keres, óó:pp:mm formában.
timeTo	szöveg	nem	Eddig az időpontig keres, óó:pp:mm formában.
page	egész	nem	Oldalszám.
sort	szöveg	nem	Rendezés: name (név) vagy price (ár). Üres érték esetén a szolgáltatások a szerkesztőfelületi sorrendjükben jönnek.

Kérés:

curl --location 'https://pelda.hu/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1/search&date=2026-03-18&location=2&page=1&services=1,2&sort=name&providers=1,3' \
--header 'Amelia: AZ_API_KULCSOD'

Válasz:

{
  "message": "Successfully retrieved searched services.",
  "data": {
    "providersServices": [
      { "1": 1, "places": null, "locations": [2], "price": 23 },
      { "2": 1, "places": null, "locations": [2], "price": 0 }
    ],
    "total": 2
  }
}

WordPress-felhasználók lekérése

Ez a végpont azokat a WordPress-felhasználókat adja vissza, amelyek nincsenek Amelia-vásárlóhoz vagy -munkavállalóhoz kötve. Akkor hasznos, ha egy új Amelia-felhasználót egy már létező WordPress-fiókhoz akarsz kapcsolni.

• Metódus: GET
• Útvonal: /users/wp-users

Paraméter	Típus	Kötelező	Leírás
role	szöveg	nem	A WordPress-felhasználó szerepkörére szűr: customer az Amelia-vásárlókhoz, provider az Amelia-munkavállalókhoz.

Kérés:

curl --location 'https://pelda.hu/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1/users/wp-users&role=customer' \
--header 'Amelia: AZ_API_KULCSOD'

Válasz:

{
  "message": "Successfully retrieved users.",
  "data": {
    "users": [
      { "value": 2, "label": "jordan.reed-example-test" },
      { "value": 35, "label": "casey.nguyen-example-test" }
    ]
  }
}

A value a WordPress-felhasználó azonosítója, ezt add meg a vásárló vagy a munkavállaló externalId mezőjében a létrehozáskor.