Docs
API referencia

API referencia

Interaktívny prehľad REST API Ellipse Cloud — 139 operácií, príklady volaní, JSON odpovede a OpenAPI špecifikácia na stiahnutie.

API v2 · aktualizované 2026-07-07

Ellipse Cloud REST API

139 dokumentovaných operácií získaných priamo z kódu demo.ellipsecloud.com/api. OAuth2 Bearer (Auth v2) alebo legacy HTTP Basic.

Stiahnuť OpenAPI YAML Auth v2 YAML RS Content YAML

Autentifikácia

Odporúčame OAuth2 Bearer tokeny (Auth v2). Podrobný návod vrátane scopes a migrácie z Basic auth: Token-based autentifikácia.

OAuth2 Token API v2 odporúčané

V admin manageri vytvorte client_id + client_secret.
POST /api/auth/v2/token s grant_type=client_credentials.
Posielajte Authorization: Bearer <access_token> na modulové endpointy.
Pri exspirácii rotujte cez grant_type=refresh_token.

Request — token

HTTP Basic (legacy)

Stále podporované do 30.09.2026 (sunset 2026-10-01T00:00:00Z). Používateľ a heslo z tabuľky api_connections, IP whitelist voliteľný.

Authorization: Basic base64(username:password)

Demo dokumentácia: ellipse / demo na demo.ellipsecloud.com.

Filtrovať endpointy

Autentifikácia

OAuth2 token API v2 nahrádza priame HTTP Basic volania. Token získate cez client_credentials, potom posielate Authorization: Bearer.

5 operácií

POST /api/auth/v2/token/

Vystavenie access + refresh tokenu (client_credentials alebo refresh_token rotation)

Auth: client_id + client_secret (Basic alebo JSON body)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/auth/v2/token/' -H 'Content-Type: application/json' -d '{"grant_type":"client_credentials","client_id":"ak_…","client_secret":"…"}'

JSON príklady

Request

Response 200

POST /api/auth/v2/revoke/

Revokácia refresh alebo access tokenu (RFC 7009)

Auth: client credentials

cURL príklad

curl -sS -X POST 'https://{tenant}/api/auth/v2/revoke/' -H 'Content-Type: application/json' -d '{"token":"rt_…"}'

JSON príklady

Request

POST /api/auth/v2/introspect/

Overenie stavu tokenu (RFC 7662)

Auth: client credentials

JSON príklady

Request

Response 200

GET /api/auth/v2/discovery/

OAuth2 metadata (TTL tokenov, podporované granty)

Auth: verejné

cURL príklad

curl -sS 'https://{tenant}/api/auth/v2/discovery/'

GET /api/auth/v2/jwks/

JWKS (HS256 — kid, bez verejného kľúča)

Auth: verejné

cURL príklad

curl -sS 'https://{tenant}/api/auth/v2/jwks/'

Rezervácie a plachta (chmbase)

CRUD operácie nad rezerváciami, izbami, cenami a dostupnosťou. GET/POST s parametrom type alebo JSON body (POST). Scope chmbase:read / chmbase:write.

21 operácií

GET /api/chmbase/?type=roomtypes chmbase:read

Zoznam typov izieb

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=roomtypes'

JSON príklady

Response 200

GET /api/chmbase/?type=roomcount&from=2026-07-08&to=2026-07-11 chmbase:read

Dostupnosť izieb podľa dátumu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=roomcount'

JSON príklady

Response 200

GET /api/chmbase/?type=stayprices&from=2026-07-08&to=2026-07-11&adults=2&children=4-6&lang=sk chmbase:read

Ceny pobytov

Poznámka: Hash v base/variant/offer/openprice platí 30 min od odpovede; datetime je čas generovania, nie expirácia. Pole price = ubytovanie + fees. V price_details: forsale = cena bez poplatkov, fees = súčet povinných poplatkov (vrátane miestnej dane; bez rozpisu po položkách). Promo zľava a cenový koeficient sa aplikujú len na ubytovanie, nie na fees.

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=stayprices&from=2026-07-08&to=2026-07-11&adults=2&children=4-6&lang=sk'

JSON príklady

Response 200

[
    {
        "room": "3",
        "room_name": "Dvojlôžková izba",
        "persons": {
            "adults": "2",
            "1": 4,
            "2": 6
        },
        "from": "2026-07-08",
        "to": "2026-07-11",
        "datetime": "2026-07-07 08:00:00",
        "langs": [
            "sk",
            "en",
            "de"
        ],
        "multiroom": 0,
        "available_for_multiroom": 2,
        "openprice": {
            "hash": "…"
        },
        "base": {
            "name": "Ubytovanie s raňajkami",
            "price": "412.50",
            "beforesale": "444.50",
            "cancellation": 1,
            "minstay": 2,
            "available": 2,
            "bookable": true,
            "hash": "…",
            "price_details": {
                "forsale": 400,
                "forsale_with_coef": 400,
                "forpercent": 432,
                "fees": 12.5,
                "total_calculation": 412.5,
                "final_price": 412.5,
                "price_type": "base_wb"
            },
            "cancellation_policy": {
                "policy_id": 2,
                "policy_type": "tiered",
                "tier_percent_by_days_before": {
                    "14": 0,
                    "4": 50,
                    "0": 100
                },
                "customer": {
                    "free_cancel_until": "2026-06-24",
                    "summary": "Bezplatné storno do 14 dní pred príchodom"
                }
            }
        },
        "variant": [
            {
                "id": "9",
                "name": "Pobyt s polpenziou",
                "price": "512.50",
                "beforesale": "552.50",
                "cancellation": 2,
                "minstay": 2,
                "available": 2,
                "bookable": true,
                "hash": "…",
                "price_details": {
                    "forsale": 500,
                    "forsale_with_coef": 500,
                    "forpercent": 540,
                    "fees": 12.5,
                    "total_calculation": 512.5,
                    "final_price": 512.5,
                    "price_type": "variant_wb"
                },
                "cancellation_policy": {
                    "policy_id": 2,
                    "policy_type": "tiered",
                    "tier_percent_by_days_before": {
                        "14": 0,
                        "4": 50,
                        "0": 100
                    },
                    "customer": {
                        "free_cancel_until": "2026-06-24",
                        "summary": "Bezplatné storno do 14 dní pred príchodom"
                    }
                }
            }
        ],
        "offer": [
            {
                "id": "42",
                "name": "Wellness hýčkanie",
                "price": "582.50",
                "beforesale": "622.50",
                "cancellation": 1,
                "minstay": 2,
                "available": 2,
                "bookable": true,
                "hash": "…",
                "price_details": {
                    "forsale": 450,
                    "forsale_with_coef": 450,
                    "forpercent": 486,
                    "fees": 12.5,
                    "total_calculation": 462.5,
                    "final_price": 462.5,
                    "price_type": "offer_wb",
                    "services": 120
                },
                "cancellation_policy": {
                    "policy_id": 2,
                    "policy_type": "tiered",
                    "tier_percent_by_days_before": {
                        "14": 0,
                        "4": 50,
                        "0": 100
                    },
                    "customer": {
                        "free_cancel_until": "2026-06-24",
                        "summary": "Bezplatné storno do 14 dní pred príchodom"
                    }
                }
            }
        ]
    }
]

GET /api/chmbase/?type=roomstdrate&from=2026-07-08&to=2026-07-11 chmbase:read

Štandardné sadzby izieb

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=roomstdrate'

JSON príklady

Response 200

GET /api/chmbase/?type=offer&offer=30 chmbase:read

Detail balíka / ponuky

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=offer'

JSON príklady

Response 200

GET /api/chmbase/?type=variant&variant=1 chmbase:read

Varianty pobytov

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=variant'

JSON príklady

Response 200

GET /api/chmbase/?type=hotelinfo chmbase:read

Informácie o hoteli

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=hotelinfo'

GET /api/chmbase/?type=gallery chmbase:read

Galéria hotela / izieb

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=gallery'

GET /api/chmbase/?type=pictograms chmbase:read

Piktogramy vybavenia

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=pictograms'

GET /api/chmbase/?type=bookingmeta chmbase:read

Meta dáta booking engine

Poznámka: Pozri BOOKING_API_META.md

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=bookingmeta'

GET /api/chmbase/?type=resinfo&rel=228880&resid=392 chmbase:read

Detail rezervácie (chmbase pohľad)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=resinfo'

JSON príklady

Response 200

GET /api/chmbase/?type=cancellation chmbase:read

Storno podmienky

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=cancellation'

JSON príklady

Response 200

POST /api/chmbase/?type=newbooking chmbase:write

Vytvorenie novej rezervácie

Poznámka: Parameter hash zo stayprices; po 30 min {"error":"Expired"}. POST s JSON body alebo query parametrami.

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=newbooking'

JSON príklady

Request

Response 200

POST /api/chmbase/?type=cancel chmbase:write

Zrušenie rezervácie

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=cancel'

JSON príklady

Response 200

POST /api/chmbase/?type=edit chmbase:write

Úprava rezervácie

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=edit'

JSON príklady

Response 200

POST /api/chmbase/?type=editdata chmbase:write

Úprava údajov hostí

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=editdata'

JSON príklady

Response 200

POST /api/chmbase/?type=addroom chmbase:write

Pridanie izby k rezervácii

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=addroom'

JSON príklady

Response 200

POST /api/chmbase/?type=deleteroom chmbase:write

Odstránenie izby z rezervácie

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=deleteroom'

JSON príklady

Response 200

POST /api/chmbase/?type=resdate chmbase:write

Zmena dátumov pobytu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=resdate'

JSON príklady

Response 200

POST /api/chmbase/?type=changeprice chmbase:write

Zmena ceny rezervácie

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=changeprice'

POST /api/chmbase/?type=edithotelbook chmbase:write

Úprava hotel book záznamu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/chmbase/?type=edithotelbook'

Pobyty a hostia (stays)

Operačné dáta hotelovej plachty — zoznam pobytov, detail rezervácie, check-in stav, hotelový účet. Scope stays:read; 1srchres vyžaduje stays:gdpr. Detail rezervácie vracia externé mapovanie: typ pobytu (`ext_stay_type_id`), služby (`mapping_code`), položky pokladne (`plu`).

24 operácií

GET /api/stays/?type=list stays:read

Zoznam pobytov / obsadenosť (anonymized=1 bez OÚ)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=list'

GET /api/stays/?type=getreservation stays:read

Detail rezervácie (resid+email/pin alebo altid)

Poznámka: Externé mapovanie: rooms[].ext_stay_type_id (manager/rooms/maping), stay_services[].mapping_code a persons[].services[].mapping_code (manager/services/maping), hotel_card_items[].plu (PLU z manager/register/items). Detail: getreservation.api.md

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=getreservation'

GET /api/stays/?type=getreservation_verified stays:read

Overený detail rezervácie

Poznámka: Rovnaké externé mapovanie ako getreservation (ext_stay_type_id, mapping_code, plu).

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=getreservation_verified'

GET /api/stays/?type=getonlinecheck stays:read

Stav online check-inu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=getonlinecheck'

GET /api/stays/?type=status stays:read

Stav rezervácie

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=status'

GET /api/stays/?type=roomstatus stays:read

Stav izby

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=roomstatus'

GET /api/stays/?type=roompairs stays:read

Mapovanie izieb

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=roompairs'

GET /api/stays/?type=persons stays:read

Osoby na izbe

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=persons'

GET /api/stays/?type=resbyphone stays:read

Vyhľadanie rezervácie podľa telefónu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=resbyphone'

GET /api/stays/?type=card stays:read

Hotelový účet (karta)

Poznámka: Položky účtu obsahujú register_item_type, register_item_id a externé PLU (manager/register/items).

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=card'

POST /api/stays/?type=paybill stays:read

Úhrada účtu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=paybill'

POST /api/stays/?type=restopay stays:read

Platba cez reštauráciu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=restopay'

GET /api/stays/?type=offers stays:read

Ponuky pre pobyt

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=offers'

GET /api/stays/?type=vouchers stays:read

Poukazy hosta

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=vouchers'

GET /api/stays/?type=partner stays:read

Partner / firma

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=partner'

GET /api/stays/?type=heatmap stays:read

Heatmapa obsadenosti

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=heatmap'

GET /api/stays/?type=pinmap stays:read

PIN mapa izieb

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=pinmap'

GET /api/stays/?type=afterstay stays:read

After-stay dotazník / follow-up

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=afterstay'

GET /api/stays/?type=sex stays:read

Číselník pohlaví

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=sex'

GET /api/stays/?type=board stays:read

Číselník stravovania

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=board'

GET /api/stays/?type=country stays:read

Číselník krajín

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=country'

GET /api/stays/?type=1srchres stays:gdpr

GDPR vyhľadávanie rezervácií

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=1srchres'

POST /api/stays/?type=cardpay stays:read

Platba hotelového účtu kartou (token z getreservation)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stays/?type=cardpay'

GET /api/stays/?type=getreservation&altid=2008281 stays:read

Príklad: detail rezervácie podľa altid (demo)

Poznámka: Ukážka s ext_stay_type_id, mapping_code (služby) a plu (položky účtu). Kompletná schéma: api/stays/getreservation.api.md

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/stays/?type=getreservation&altid=2008281'

JSON príklady

Response 200

{
    "resinfo": {
        "id": "2008281",
        "token": "WU5SNC9EU0NtNC9QVVFVOFdSWVJNUT09",
        "email": "peter.sveter@example.com",
        "name": "Peter",
        "surname": "Sveter",
        "lang": "sk",
        "statusid": "12",
        "selfcheck": "https:\/\/selfcheckin.app\/JK7TBK",
        "statusname": "Neuhradená",
        "online_checkin_status": 0,
        "hotel_account": {
            "total_on_card_vat": 651.8,
            "balance_due_vat": 651.8,
            "currency": "EUR"
        },
        "stay_services": [
            {
                "id": 133,
                "title": "1 hodinový vstup",
                "line_price": 10,
                "source": "package",
                "in_package": true,
                "mapping_code": "WELL-1H",
                "currency": "EUR"
            },
            {
                "id": 120,
                "title": "Ajurvédska masáž 50 min.",
                "line_price": 90,
                "source": "package",
                "in_package": true,
                "mapping_code": "SPA-AYUR50",
                "currency": "EUR"
            },
            {
                "id": 146,
                "title": "Degustačná večera",
                "line_price": 30,
                "source": "package",
                "in_package": true,
                "mapping_code": "GAST-DEG30",
                "currency": "EUR"
            },
            {
                "id": 115,
                "title": "Fľaša vína",
                "line_price": 9,
                "source": "package",
                "in_package": true,
                "mapping_code": "FB-WINE750",
                "currency": "EUR"
            },
            {
                "id": 106,
                "title": "Masáž balíčková 20 Eur",
                "line_price": 20,
                "source": "package",
                "in_package": true,
                "mapping_code": "SPA-MASS20",
                "currency": "EUR"
            },
            {
                "id": 28,
                "title": "Reflexná masáž 60 min.",
                "line_price": 17,
                "source": "package",
                "in_package": true,
                "mapping_code": "SPA-REF60",
                "currency": "EUR"
            }
        ],
        "stay_price_services_persons": [
            {
                "reservation_person_id": 37180,
                "id_room": 35,
                "idp": 1,
                "services": [
                    {
                        "source": "package",
                        "service_id": 133,
                        "book_service_id": 252,
                        "title": "1 hodinový vstup",
                        "line_price": 10,
                        "mapping_code": "WELL-1H",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 120,
                        "book_service_id": 261,
                        "title": "Ajurvédska masáž 50 min.",
                        "line_price": 90,
                        "mapping_code": "SPA-AYUR50",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 146,
                        "book_service_id": 256,
                        "title": "Degustačná večera",
                        "line_price": 30,
                        "mapping_code": "GAST-DEG30",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 115,
                        "book_service_id": 260,
                        "title": "Fľaša vína",
                        "line_price": 9,
                        "mapping_code": "FB-WINE750",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 106,
                        "book_service_id": 254,
                        "title": "Masáž balíčková 20 Eur",
                        "line_price": 20,
                        "mapping_code": "SPA-MASS20",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 106,
                        "book_service_id": 258,
                        "title": "Masáž balíčková 20 Eur",
                        "line_price": 20,
                        "mapping_code": "SPA-MASS20",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 28,
                        "book_service_id": 270,
                        "title": "Reflexná masáž 60 min.",
                        "line_price": 17,
                        "mapping_code": "SPA-REF60",
                        "in_package": true,
                        "currency": "EUR"
                    }
                ]
            },
            {
                "reservation_person_id": 37181,
                "id_room": 35,
                "idp": 2,
                "services": [
                    {
                        "source": "package",
                        "service_id": 133,
                        "book_service_id": 253,
                        "title": "1 hodinový vstup",
                        "line_price": 10,
                        "mapping_code": "WELL-1H",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 120,
                        "book_service_id": 262,
                        "title": "Ajurvédska masáž 50 min.",
                        "line_price": 90,
                        "mapping_code": "SPA-AYUR50",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 146,
                        "book_service_id": 257,
                        "title": "Degustačná večera",
                        "line_price": 30,
                        "mapping_code": "GAST-DEG30",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 175,
                        "book_service_id": 269,
                        "title": "Konzum 50e 5%",
                        "line_price": 50,
                        "mapping_code": "FB-KONZ50",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 106,
                        "book_service_id": 255,
                        "title": "Masáž balíčková 20 Eur",
                        "line_price": 20,
                        "mapping_code": "SPA-MASS20",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 106,
                        "book_service_id": 259,
                        "title": "Masáž balíčková 20 Eur",
                        "line_price": 20,
                        "mapping_code": "SPA-MASS20",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "package",
                        "service_id": 28,
                        "book_service_id": 271,
                        "title": "Reflexná masáž 60 min.",
                        "line_price": 17,
                        "mapping_code": "SPA-REF60",
                        "in_package": true,
                        "currency": "EUR"
                    },
                    {
                        "source": "web_booking_person",
                        "service_id": null,
                        "book_service_id": null,
                        "title": "Parkovanie (WB doplnok na osobu)",
                        "line_price": null,
                        "mapping_code": "PARK-1",
                        "in_package": null,
                        "currency": "EUR",
                        "uid": "2008281-2-45-1"
                    }
                ]
            }
        ],
        "hotel_card_items": [
            {
                "id": 81445,
                "room_id": 35,
                "register_item_type": "reg",
                "register_item_id": 84,
                "plu": "MASSAGE84",
                "title": "Masáže \/ Massage 84",
                "vat_rate_percent": 23,
                "price_unit_vat": 20,
                "lot": 2,
                "amount_vat": 40
            },
            {
                "id": 81446,
                "room_id": 35,
                "register_item_type": "cal",
                "register_item_id": 13,
                "plu": "MENU-DUCK",
                "title": "Kačacie stehno s červenou kapustou 320g",
                "vat_rate_percent": 5,
                "price_unit_vat": 20,
                "lot": 2,
                "amount_vat": 40
            },
            {
                "id": 81448,
                "room_id": 35,
                "register_item_type": "reg",
                "register_item_id": 226,
                "plu": "FB-FM075",
                "title": "Frankovka modrá 0,75l",
                "vat_rate_percent": 23,
                "price_unit_vat": 9,
                "lot": 1,
                "amount_vat": 9
            },
            {
                "id": 81450,
                "room_id": 35,
                "register_item_type": "reg",
                "register_item_id": 8,
                "plu": "TAX-LOCAL",
                "title": "Miestny poplatok \/ Local tax",
                "vat_rate_percent": 0,
                "price_unit_vat": 1.5,
                "lot": 2,
                "amount_vat": 3
            },
            {
                "id": 81453,
                "room_id": 35,
                "register_item_type": "reg",
                "register_item_id": 3039,
                "plu": "CRED-STAY",
                "title": "Kredit konzumné k pobytu",
                "vat_rate_percent": 5,
                "price_unit_vat": 50,
                "lot": 1,
                "amount_vat": 50
            },
            {
                "id": 81457,
                "room_id": 35,
                "register_item_type": "reg",
                "register_item_id": 7,
                "plu": "ROOM-ACC",
                "title": "Ubytovanie \/ Accommodation",
                "vat_rate_percent": 5,
                "price_unit_vat": 63.6,
                "lot": 1,
                "amount_vat": 63.6
            },
            {
                "id": 81456,
                "room_id": 35,
                "register_item_type": "reg",
                "register_item_id": 50,
                "plu": "FB-BFAST",
                "title": "Raňajky dospelý \/ Breakfast adults",
                "vat_rate_percent": 5,
                "price_unit_vat": 14,
                "lot": 2,
                "amount_vat": 28
            }
        ]
    },
    "rooms": [
        {
            "idroom": "24339",
            "ext_stay_type_id": "DLX-BB-114",
            "roomname": "511",
            "uidroom": "35",
            "rateid": "114",
            "ratetype": "offer",
            "arrival": "2026-06-05",
            "departure": "2026-06-08",
            "checkin_time": "14:00",
            "checkout_time": "10:00",
            "roomstatus": "waiting",
            "clean": "false",
            "persons": [
                {
                    "id": "37180",
                    "name": "Peter",
                    "surname": "Sveter",
                    "services": [
                        {
                            "source": "package",
                            "service_id": 133,
                            "book_service_id": 252,
                            "title": "1 hodinový vstup",
                            "line_price": 10,
                            "mapping_code": "WELL-1H",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 120,
                            "book_service_id": 261,
                            "title": "Ajurvédska masáž 50 min.",
                            "line_price": 90,
                            "mapping_code": "SPA-AYUR50",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 146,
                            "book_service_id": 256,
                            "title": "Degustačná večera",
                            "line_price": 30,
                            "mapping_code": "GAST-DEG30",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 115,
                            "book_service_id": 260,
                            "title": "Fľaša vína",
                            "line_price": 9,
                            "mapping_code": "FB-WINE750",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 106,
                            "book_service_id": 254,
                            "title": "Masáž balíčková 20 Eur",
                            "line_price": 20,
                            "mapping_code": "SPA-MASS20",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 106,
                            "book_service_id": 258,
                            "title": "Masáž balíčková 20 Eur",
                            "line_price": 20,
                            "mapping_code": "SPA-MASS20",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 28,
                            "book_service_id": 270,
                            "title": "Reflexná masáž 60 min.",
                            "line_price": 17,
                            "mapping_code": "SPA-REF60",
                            "in_package": true,
                            "currency": "EUR"
                        }
                    ]
                },
                {
                    "id": "37181",
                    "name": "Druhá",
                    "surname": "Osoba",
                    "services": [
                        {
                            "source": "package",
                            "service_id": 133,
                            "book_service_id": 253,
                            "title": "1 hodinový vstup",
                            "line_price": 10,
                            "mapping_code": "WELL-1H",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 120,
                            "book_service_id": 262,
                            "title": "Ajurvédska masáž 50 min.",
                            "line_price": 90,
                            "mapping_code": "SPA-AYUR50",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 146,
                            "book_service_id": 257,
                            "title": "Degustačná večera",
                            "line_price": 30,
                            "mapping_code": "GAST-DEG30",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 175,
                            "book_service_id": 269,
                            "title": "Konzum 50e 5%",
                            "line_price": 50,
                            "mapping_code": "FB-KONZ50",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 106,
                            "book_service_id": 255,
                            "title": "Masáž balíčková 20 Eur",
                            "line_price": 20,
                            "mapping_code": "SPA-MASS20",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 106,
                            "book_service_id": 259,
                            "title": "Masáž balíčková 20 Eur",
                            "line_price": 20,
                            "mapping_code": "SPA-MASS20",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "package",
                            "service_id": 28,
                            "book_service_id": 271,
                            "title": "Reflexná masáž 60 min.",
                            "line_price": 17,
                            "mapping_code": "SPA-REF60",
                            "in_package": true,
                            "currency": "EUR"
                        },
                        {
                            "source": "web_booking_person",
                            "service_id": null,
                            "book_service_id": null,
                            "title": "Parkovanie (WB doplnok na osobu)",
                            "line_price": null,
                            "mapping_code": "PARK-1",
                            "in_package": null,
                            "currency": "EUR",
                            "uid": "2008281-2-45-1"
                        }
                    ]
                }
            ]
        }
    ]
}

Doklady a účtovníctvo (money)

Faktúry, bločky, pokladničné položky, partneri. Scope money:read / money:write.

21 operácií

GET /api/money/?type=vat money:read

Sadzby DPH

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=vat'

GET /api/money/?type=regitems money:read

Položky registra

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=regitems'

GET /api/money/?type=regsets money:read

Sety položiek

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=regsets'

GET /api/money/?type=registers money:read

Pokladne / registre

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=registers'

GET /api/money/?type=regcat money:read

Kategórie registra

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=regcat'

GET /api/money/?type=invcat money:read

Kategórie faktúr

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=invcat'

GET /api/money/?type=invgroup money:read

Skupiny faktúr

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=invgroup'

GET /api/money/?type=invlist money:read

Zoznam faktúr

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=invlist'

GET /api/money/?type=billslist money:read

Zoznam bločkov

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=billslist'

GET /api/money/?type=exbillslist money:read

Externé bločky — zoznam

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=exbillslist'

GET /api/money/?type=exbill money:read

Externý bloček — detail

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=exbill'

GET /api/money/?type=bill money:read

Detail bločku

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=bill'

GET /api/money/?type=lastinvid money:read

Posledné ID faktúry

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=lastinvid'

GET /api/money/?type=lastbillid money:read

Posledné ID bločku

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=lastbillid'

GET /api/money/?type=invrange money:read

Rozsah faktúr

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=invrange'

GET /api/money/?type=billrange money:read

Rozsah bločkov

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=billrange'

GET /api/money/?type=getpartner money:read

Detail partnera

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=getpartner'

POST /api/money/?type=invoice money:write

Vytvorenie faktúry

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=invoice'

POST /api/money/?type=invpayment money:write

Platba faktúry

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=invpayment'

POST /api/money/?type=billspayment money:write

Platba bločkov

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=billspayment'

POST /api/money/?type=addpartner money:write

Pridanie partnera

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/money/?type=addpartner'

CRM

Správa CRM kontaktov, kredit, insight. Vyžaduje crm_api=1 na pripojení + príslušný sub-scope.

7 operácií

GET /api/crm/?type=users&limit=100&offset=0 crm:list

Zoznam CRM používateľov (limit/offset)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/crm/?type=users'

JSON príklady

Response 200

GET /api/crm/?type=profile&idcrm=42 crm:profile

Profil CRM kontaktu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/crm/?type=profile'

GET /api/crm/?type=insight&idcrm=42 crm:insight

CRM insight (kredit, obrat, VIP)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/crm/?type=insight'

JSON príklady

Response 200

POST /api/crm/?type=credit_add crm:credit_add

Pripísanie kreditu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -X POST -H 'Authorization: Bearer $TOKEN' -H 'Content-Type: application/json' 'https://{tenant}/api/crm/?type=credit_add' -d '{"idcrm":42,"amount":25.5}'

JSON príklady

Request

POST /api/crm/?type=credit_sub crm:credit_sub

Odpočítanie kreditu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

JSON príklady

Request

POST /api/crm/?type=user_add crm:user_add

Registrácia nového CRM kontaktu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

JSON príklady

Request

POST /api/crm/?type=user_remove crm:user_remove

Odstránenie CRM kontaktu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

JSON príklady

Request

Hotelový účet — zápis (bor / bor2)

Pripísanie položiek na izbu / hotelový účet hosta. bor scope bor:write, bor2 scope bor2:write.

5 operácií

GET /api/bor/?type=roompairs bor:write

Mapovanie izieb pre zápis

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/bor/?type=roompairs'

GET /api/bor/?type=checkroom bor:write

Overenie izby pred zápisom

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/bor/?type=checkroom'

POST /api/bor/?type=billtoroom bor:write

Zápis položky na hotelový účet izby

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/bor/?type=billtoroom'

JSON príklady

Request

Response 200

GET /api/bor2/?type=openbills bor2:write

Otvorené účty

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/bor2/?type=openbills'

POST /api/bor2/?type=billtoroom bor2:write

Zápis položky (bor2)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/bor2/?type=billtoroom'

Pokladne a zľavové kódy (register)

Správa zľavových QR kódov a pokladničných operácií. Scope register:read / register:write.

6 operácií

GET /api/register/?type=registerlist register:read

Zoznam pokladní

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/register/?type=registerlist'

GET /api/register/?type=listsc register:read

Zoznam zľavových kódov

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/register/?type=listsc'

GET /api/register/?type=used register:read

Použité kódy

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/register/?type=used'

GET /api/register/?type=invoice_head register:read

Hlavička faktúry z pokladne

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/register/?type=invoice_head'

POST /api/register/?type=setsc register:write

Vytvorenie / úprava zľavového kódu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/register/?type=setsc'

POST /api/register/?type=deletesc register:write

Zmazanie zľavového kódu

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/register/?type=deletesc'

Služby (services)

Rezervácie služieb a oblastí (wellness, gastro). Scope services:read.

2 operácií

GET /api/services/?type=areas services:read

Oblasti / zóny služieb

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/services/?type=areas'

GET /api/services/?type=reservations services:read

Rezervácie služieb

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/services/?type=reservations'

Web booking & kanály

Endpointy pre booking engine a channel manager. Autentifikácia cez Bearer/Basic so scope wb:*. Pre analytiku vyhľadávaní (LYST / Looker) pozri modul Booking analytika.

6 operácií

GET /api/rooms/ wb:rooms

Zoznam izieb pre web booking

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/rooms/'

GET /api/offers/ wb:offers

Ponuky / balíky

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/offers/'

GET /api/checkroomsavailability/ wb:availability

Dostupnosť izieb

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/checkroomsavailability/'

GET /api/checkpricescallendar/ wb:prices

Cenový kalendár

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/checkpricescallendar/'

GET /api/stayprices/ wb:stayprices

Ceny pobytov (WB)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/stayprices/'

POST /api/multiellipsebookingdl/ wb:bookings

Multi-property booking download

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/multiellipsebookingdl/'

Booking analytika

Export vyhľadávaní a konverzií z web booking engine pre externé BI (Looker Studio, BigQuery). Scope analytics:booking — na API spojení zapnite Booking analytika API (analytics_api). Súvisí s reportom manager web/13 (YoY / LYST).

4 operácií

GET

/api/analytics/?type=booking_events&event_date_from=2026-06-01&event_date_to=2026-06-30&stay_date_from=2026-07-01&stay_date_to=2026-08-31&funnel_step=1&limit=1000&offset=0

analytics:booking

Event log vyhľadávaní — kedy (event_date) host hľadal ktorý termín (stay_date). Odporúčané pre LYST v Looker.

Poznámka: Query: event_date_from/to (deň udalosti), stay_date_from/to (termín pobytu), funnel_step 1–4, limit max 5000. Bez PII (bez session_id).

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/analytics/?type=booking_events&event_date_from=2026-06-01&event_date_to=2026-06-30&funnel_step=1'

JSON príklady

Response 200

GET /api/analytics/?type=booking_aggregates&stay_date_from=2026-07-01&stay_date_to=2026-08-31&limit=500 analytics:booking

Agregát podľa termínu príchodu (stay_date) — kumulatívny stav z reservations_stats.

Poznámka: Rovnaká logika ako report Web Booking /13. Nie je to historický snapshot — pre LYST použite booking_events alebo booking_snapshots.

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/analytics/?type=booking_aggregates&stay_date_from=2026-07-01&stay_date_to=2026-08-31'

JSON príklady

Response 200

GET /api/analytics/?type=booking_snapshots&snapshot_date=2026-06-08&stay_date_from=2026-07-01&stay_date_to=2026-08-31 analytics:booking

Denné snímky stavu vyhľadávaní (snapshot_date) — zdroj pre LYST v reporte aj v BI.

Poznámka: Snapshoty vznikajú denným cronom (tabuľka reservations_stats_snapshot, migrácia 1115). Query: snapshot_date alebo snapshot_date_from/to.

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/analytics/?type=booking_snapshots&snapshot_date=2026-06-08'

JSON príklady

Response 200

GET /api/analytics/?type=docs analytics:booking

Markdown dokumentácia modulu (Looker workflow, GDPR, príklady LYST)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://{tenant}/api/analytics/?type=docs'

RS Content API

Verejné read-only JSON API nad redakčným obsahom (články, izby, balíky, poukazy). OpenAPI: /api/rs/RS_CONTENT_API.yaml

17 operácií

GET /api/rs/?type=meta&lang=sk

RS obsah: meta

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=meta&lang=sk'

GET /api/rs/?type=articles&lang=sk

RS obsah: articles

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=articles&lang=sk'

GET /api/rs/?type=article&lang=sk

RS obsah: article

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=article&lang=sk'

GET /api/rs/?type=banners&lang=sk

RS obsah: banners

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=banners&lang=sk'

GET /api/rs/?type=text&lang=sk

RS obsah: text

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=text&lang=sk'

GET /api/rs/?type=categories&lang=sk

RS obsah: categories

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=categories&lang=sk'

GET /api/rs/?type=category_articles&lang=sk

RS obsah: category_articles

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=category_articles&lang=sk'

GET /api/rs/?type=articles_latest&lang=sk

RS obsah: articles_latest

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=articles_latest&lang=sk'

GET /api/rs/?type=galleries&lang=sk

RS obsah: galleries

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=galleries&lang=sk'

GET /api/rs/?type=gallery&lang=sk

RS obsah: gallery

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=gallery&lang=sk'

GET /api/rs/?type=rooms&lang=sk

RS obsah: rooms

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=rooms&lang=sk'

GET /api/rs/?type=room&lang=sk

RS obsah: room

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=room&lang=sk'

GET /api/rs/?type=room_filters_catalog&lang=sk

RS obsah: room_filters_catalog

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=room_filters_catalog&lang=sk'

GET /api/rs/?type=offers&lang=sk

RS obsah: offers

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=offers&lang=sk'

GET /api/rs/?type=offers_top&lang=sk

RS obsah: offers_top

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=offers_top&lang=sk'

GET /api/rs/?type=vouchers&lang=sk

RS obsah: vouchers

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=vouchers&lang=sk'

GET /api/rs/?type=events&lang=sk

RS obsah: events

Auth: HTTP Basic (api_connections)

cURL príklad

curl -sS -u 'ellipse:demo' 'https://{tenant}/api/rs/?type=events&lang=sk'

RMS — katalóg izieb

Verejný katalóg izieb pre RMS integrácie. rmsbookings vyžaduje autentifikáciu.

3 operácií

GET /api/rms/?type=langs

Podporované jazyky

Auth: verejné

cURL príklad

curl -sS 'https://{tenant}/api/rms/?type=langs'

GET /api/rms/?type=list

Katalóg izieb s fotkami a vybavením

Auth: verejné

cURL príklad

curl -sS 'https://{tenant}/api/rms/?type=list'

GET /api/rms/?type=rmsbookings&from=2026-01-01&to=2026-01-31 rms:read

Anonymizované rezervácie pre RMS

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $TOKEN' 'https://{tenant}/api/rms/?type=rmsbookings&from=2026-01-01&to=2026-01-31'

MCP Gateway (AI integrácie)

Endpointy pre AI asistentov (ChatGPT, Claude, Gemini). HMAC podpis okrem health/discovery. Kanonický gateway: mcp.ellipsecloud.com

12 operácií

GET /api/mcp/v1/health/ verejné

Health check

Auth: verejné

cURL príklad

curl -sS -X GET 'https://{tenant}/api/mcp/v1/health/'

GET /api/mcp/v1/discovery/ verejné

Discovery profil

Auth: verejné

cURL príklad

curl -sS -X GET 'https://{tenant}/api/mcp/v1/discovery/'

GET /api/mcp/v1/profile/ HMAC

Profil hotela

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X GET 'https://{tenant}/api/mcp/v1/profile/'

POST /api/mcp/v1/availability/ HMAC

Dostupnosť

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/mcp/v1/availability/'

POST /api/mcp/v1/offers/ HMAC

Ponuky

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/mcp/v1/offers/'

POST /api/mcp/v1/quote/ HMAC

Cenová ponuka

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/mcp/v1/quote/'

POST /api/mcp/v1/best_price_periods/ HMAC

Najlepšie obdobia cien

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/mcp/v1/best_price_periods/'

POST /api/mcp/v1/gift_vouchers/ HMAC

Darčekové poukazy

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/mcp/v1/gift_vouchers/'

POST /api/mcp/v1/service_timeslots/ HMAC

Termíny služieb

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/mcp/v1/service_timeslots/'

GET /api/mcp/v1/contract-party/ HMAC

Fakturačné údaje

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X GET 'https://{tenant}/api/mcp/v1/contract-party/'

POST /api/mcp/v1/area-booking-ingest/ HMAC

Import area booking

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/mcp/v1/area-booking-ingest/'

POST /api/mcp/v1/area-booking-cancel/ HMAC

Zrušenie area booking

Auth: HMAC (mcp_secret)

cURL príklad

curl -sS -X POST 'https://{tenant}/api/mcp/v1/area-booking-cancel/'

Hardvérové integrácie

Assa Abloy, Salto, iCal export. Vyžadujú povolené API pripojenie alebo token v URL.

3 operácií

POST /api/assaabloy/ assaabloy:write

Assa Abloy Visionline — vydanie / prepísanie karty

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -X POST -H 'Authorization: Bearer $TOKEN' 'https://{tenant}/api/assaabloy/' -H 'Content-Type: application/json' -d '{"room":3,"resid":2004277,"start":"2026-08-15 12:00","end":"2026-08-20 12:00"}'

JSON príklady

Request

Response 200

POST /api/salto/ salto:write

Salto zámky — vydanie karty (rovnaká JSON štruktúra ako Assa Abloy)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -X POST -H 'Authorization: Bearer $TOKEN' 'https://{tenant}/api/salto/' -H 'Content-Type: application/json' -d '{…}'

JSON príklady

Request

GET /api/ical/{room|area}/{token}.ical.ics

iCal export (RFC 5545) pre OTA a kalendáre

Auth: token v URL

cURL príklad

curl -sS 'https://{tenant}/api/ical/room/TOKEN.ical.ics'

Gastro — vydané objednávky (regorders)

Polling vybavených objednávok z kuchyne pre bzučiaky a výdajné miesta. Odporúčame obmedziť prístup IP firewallom.

1 operácií

GET /api/regorders/?type=all register:read

Vybavené objednávky (dnes alebo od fromid)

Auth: Bearer JWT (Auth v2) alebo HTTP Basic (legacy do 30.09.2026)

cURL príklad

curl -sS -H 'Authorization: Bearer $TOKEN' 'https://{tenant}/api/regorders/?type=all'

JSON príklady

Response 200

Periférie — čítačky a datastore

Integrácie s čítačkami dokladov a periférnymi zariadeniami. Hash reťazec a IP whitelist sa nastavujú individuálne v admine.

2 operácií

POST /api/datastore/?hash={service}-{device}-{encryptedId}

Zápis JSON dát z periférie (prepíše predchádzajúce dáta pre rovnaký hash)

Auth: hash v URL + IP whitelist

cURL príklad

curl -sS -X POST 'https://{tenant}/api/datastore/?hash=1-1-…' -H 'Content-Type: application/json' -d '{"data":{"temperature":4.2}}'

JSON príklady

Request

Response 200

POST /api/validate/?type=1&client={clientId}

Validácia QR dokladu (integrácia na mieru — kontaktujte support)

Auth: client ID + IP whitelist

JSON príklady

Request

Response 200

Tematické články

Podrobné návody k jednotlivým oblastiam integrácie.