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

> A szabad időpontok keresése a keresőűrlap folyamatához, és a még nem Ameliához kötött WordPress-felhasználók lekérése.

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](https://hub.hellowp.io/hu/plugins/ameliabooking/fejlesztoknek-api-attekintes/) 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:

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

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

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

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