API végpontok

Olvasás

• GET /api/v1/me – a kulcshoz tartozó vállalkozás alapadatai
• GET /api/v1/services – szolgáltatások
• GET /api/v1/employees – munkatársak
• GET /api/v1/locations – helyszínek
• GET /api/v1/customers – vendégek
• GET /api/v1/availability – szabad idősávok egy napra
• GET /api/v1/bookings – foglalások

Írás

• POST /api/v1/bookings – új foglalás
• POST /api/v1/bookings/{id}/cancel – lemondás

Foglalás létrehozása

POST /api/v1/bookings
Content-Type: application/json

{
  "serviceId": "svc_...",
  "employeeId": "emp_...",
  "locationId": "loc_...",
  "start": "2026-09-20T09:00:00Z",
  "customer": {
    "name": "Kiss Anna",
    "email": "anna@example.com",
    "phone": "+36301234567"
  }
}

A foglalás ugyanazon a belső logikán megy keresztül, mint a weboldalról érkező: ugyanaz az ellenőrzés, ugyanaz a zárolás, ugyanazok az e-mailek. Nincs külön, lazább API-út.

Ha a szolgáltatáshoz kártyás előleg tartozik, a válasz deposit.checkoutUrl mezőjében érkezik a fizetési oldal címe: erre kell irányítani a vendéget. Az időpont 35 percig van fenntartva; ha addig nem fizet, a foglalás magától lemondódik. Ha a mező null, a foglalás online előleg nélkül érvényes.