API Dokumentácia

Autentifikácia

Každý request musí obsahovať hlavičku X-API-Key s vaším API kľúčom. API kľúče si vygenerujete v Nastaveniach → API prístup.

curl -H "X-API-Key: VÁŠ_API_KĽÚČ" https://api.planivo.sk/api/external/bookings

Vráti posledných 100 rezervácií vášho podniku vrátane detailov služby a zamestnanca.

curl -H "X-API-Key: VÁŠ_API_KĽÚČ" \
  https://api.planivo.sk/api/external/bookings

Príklad odpovede:

[
  {
    "id": "clx1abc...",
    "startTime": "2026-07-05T10:00:00.000Z",
    "endTime": "2026-07-05T11:00:00.000Z",
    "status": "CONFIRMED",
    "clientName": "Ján Novák",
    "clientEmail": "jan@example.com",
    "clientPhone": "+421900000000",
    "totalPrice": 45,
    "note": null,
    "createdAt": "2026-07-01T08:00:00.000Z",
    "service": { "id": "...", "name": "Masáž chrbta", "duration": 60, "price": 45 },
    "employee": { "id": "...", "name": "Jana Kováčová" }
  }
]

Vráti zoznam aktívnych služieb vášho podniku.

curl -H "X-API-Key: VÁŠ_API_KĽÚČ" \
  https://api.planivo.sk/api/external/services

Príklad odpovede:

[
  {
    "id": "clx2def...",
    "name": "Masáž chrbta",
    "description": "60 minútová masáž chrbta a šije",
    "duration": 60,
    "price": 45,
    "currency": "EUR",
    "isActive": true
  }
]

Vráti unikátnych zákazníkov (deduplikované podľa emailu), zoradených od najnovšieho.

curl -H "X-API-Key: VÁŠ_API_KĽÚČ" \
  https://api.planivo.sk/api/external/customers

Príklad odpovede:

[
  {
    "name": "Ján Novák",
    "email": "jan@example.com",
    "phone": "+421900000000",
    "firstBookingAt": "2026-06-15T09:00:00.000Z"
  }
]

Chybové kódy