MemberPro API — Kompletní dokumentace

Base URL: http://62.109.132.9:9296

Auth: Basic Auth (jméno + heslo přiděleny na vyžádání, test: test/test)

Formát: JSON (podporuje i XML)

Datum testování: 20.03.2026

Obsah

• Přehled a autentizace
• Resorty
• Kategorie služeb
• Služby
• Volné termíny (Freetime)
• Lekce
• Kurty
• Místnosti
• Maséři / Personál
• Členství
• Login / Přihlášení
• User / Klient
• Registrace
• Reset hesla
• Validate
• Rezervace
• Watchdog (hlídání termínů)
• Vouchery
• Platby
• Feedback
• Akce / Promo
• SMS
• Stav endpointů — co funguje a co ne

Přehled

API předpokládá komunikaci pomocí HTTPS a povolení komunikace z určených IP adres.

Pro autorizaci se používá Basic Auth (HTTP hlavička Authorization: Basic base64(jmeno:heslo)).

Všechny endpointy vrací JSON (application/json) nebo XML (application/xml).

POST/PUT endpointy přijímají application/json, application/xml a application/x-www-form-urlencoded.

Důležité konvence:

• Hesla se posílají jako MD5 hash
• login je typicky email uživatele (pokud není dohodnuto jinak)
• Parametr lang (jazyk) defaultuje na cz
• User ID reálných uživatelů začínají kolem 4000000 (ne od 1)
• Formát data se liší podle endpointu (viz poznámky u jednotlivých)

Resorty

GET api/Resorts

Seznam poboček/resortů.

Parametry: žádné

Response: 200 OK — Array of Resort_data

Příklad odpovědi:

[{"id": 1, "nazev": "Premier fitness"}]

Stav: ✅ Funguje

Kategorie

GET api/Categories?lang={lang}

Seznam kategorií služeb.

Response: Array of Categories_data

Stav: ✅ Funguje (v testovacím prostředí 1 kategorie: 10001 "Prodej členství")

Služby

GET api/Services?resort={resort}&id_kategorie={id_kategorie}&user_id={user_id}&id_resource={id_resource}&lang={lang}

Seznam služeb s cenami.

Důležité: Ceny se liší podle user_id — člen dostává členskou cenu (např. 50% sleva pro typ "Majitel").

Response: Array of Services_data

service_detail:

Příklad odpovědi:

[
  {"id":900004011,"nazev":"Roční členství NAJEDNOU","kategorie":"10001","resort":1,
   "service_detail":[{"id":900004011,"delka":0,"cena":15990.0,"posible":1,"primy_prodej":1,"stav_skladu":999,"voucher":0}]},
  {"id":900004007,"nazev":"10 vstupů","kategorie":"10001","resort":1,
   "service_detail":[{"id":900004007,"delka":0,"cena":1600.0,"posible":1}]},
  {"id":900004008,"nazev":"20 vstupů","kategorie":"10001","resort":1,
   "service_detail":[{"id":900004008,"delka":0,"cena":3000.0,"posible":1}]},
  {"id":900004005,"nazev":"Měsíční členství","kategorie":"10001","resort":1,
   "service_detail":[{"id":900004005,"delka":0,"cena":1790.0,"posible":1}]}
]

Stav: ✅ Funguje (pouze kategorie 10001 má data)

GET api/Services/free?resort={resort}&id_kategorie={id_kategorie}&user_id={user_id}&datum_start={datum_start}&pohlavi_maser={pohlavi_maser}

Dostupné služby k danému datu.

Response: Stejná struktura jako Services.

Stav: ❌ 500 Error — chybí stored procedure API_HUMANIT_II_GET_SLUZBY_FRE_G

Freetime

GET api/Freetime?resort={resort}&date_start={date_start}&id_kategorie={id_kategorie}&user_id={user_id}&id_maser={id_maser}&id_sluzby_1={id_sluzby_1}&id_sluzby_2={id_sluzby_2}&pocet_dni_dopredu={pocet_dni_dopredu}&lang={lang}

Volné termíny pro rezervaci.

Response: Array of Freetime_data

Stav: ⚠️ Endpoint existuje, ale padá s "numeric overflow" pro kategorii 10001. Pro ostatní kategorie vrací prázdné pole.

Lekce

GET api/Lesson/variants?lang={lang}

Varianty/typy lekcí.

Response: Array of Lesson_variants_data

Příklad:

[
  {"varianta_lekce":1,"nazev":"skupinove","popis":"skupinove"},
  {"varianta_lekce":11,"nazev":"aerobik","popis":"aerobik"},
  {"varianta_lekce":13,"nazev":"yoga","popis":"yoga"},
  {"varianta_lekce":17,"nazev":"spinning","popis":"spinning"},
  {"varianta_lekce":23,"nazev":"zumba","popis":"zumba"}
]

19 typů: skupinove, vacu, photon, aerobik, pilates, yoga, trx, gravity, kruhovy, spinning, bodystyling, hit4fit, expander, tehulky, bosu, zumba, trampolinky, deti, bojove_sporty

Stav: ✅ Funguje

GET api/Lesson?resort={resort}&date_start={date_start}&id_kategorie={id_kategorie}&user_id={user_id}&pocet_dni_dopredu={pocet_dni_dopredu}&id_service={id_service}&lang={lang}

Rozvrh lekcí.

Formát data: DD.MM.YYYY (ne ISO formát!)

Response: Array of Lesson_data

Stav: ✅ Funguje (v testu prázdný — žádné lekce naplánovány)

Kurty

GET api/Courts?resort={resort}&id_kategorie={id_kategorie}&datum={datum}

Seznam kurtů/sportovišť.

Response: Array of Courts_data

Příklad: [{"id_resource":100,"nazev":"Posilovna","resort":1,"kategorie":100,"platnost_do":"2099-12-31T00:00:00"}]

Stav: ✅ Funguje (kategorie 100)

Místnosti

GET api/Room?lang={lang}

Seznam cvičebních sálů.

Response: Array of Room_data

Data: 6 sálů — Aerobik (1), Funkční tr. (4), Cross GYM (5), Fighting arena 1 (6), Fighting arena 2 (7), Outdoor (8)

Stav: ✅ Funguje

Personál

GET api/Masseurs

Seznam masérů.

Response: Array of Masseur_data — { resort, id, jmeno, prijmeni, pohlavi }

Stav: ⚠️ 404 (žádní maséři v testovací DB)

GET api/Staff

Seznam personálu (maséři, trenéři...).

Response: Array of Staff_data — { resort, id, jmeno, prijmeni, pohlavi, id_typ_sportoviste, kategorie }

Stav: ⚠️ 404 (žádný personál v testovací DB)

Členství

GET api/Clenstvi?lang={lang}

Typy členství.

Response: Array of Clenstvi_data

Stav: ✅ Funguje (51 typů členství)

Login

GET api/Login?login={login}

Lookup uživatele dle emailu.

Response: User_id_data

{"user_id": 4000012, "state": 0}

• user_id: -1 = nenalezen
• state: 0=reg. na recepci, 1=registrován, 2=email odeslán, 3=potvrzeno

Stav: ✅ Funguje

GET/POST api/Login?login={login}&password={password}&member_card_number={member_card_number}

Plné přihlášení klienta.

Response: User_data (kompletní profil — viz sekce User)

HTTP kódy:

• 200 = OK
• 409 = Duplicita A (více klientů, alespoň jeden s kartou)
• 406 = Duplicita B (více klientů, žádný s kartou)
• 404 = Nenalezeno

Stav: ✅ Funguje

User

GET api/User?user_id={user_id}

Kompletní data klienta.

Response: User_data

{
  "user_id": 4000012,
  "login": "info@premierfitness.cz",
  "email": "info@premierfitness.cz",
  "name": "Pavel",
  "surname": "Precek",
  "title_before": "",
  "title_after": "",
  "birthdate": "1981-02-01T00:00:00",
  "current_balance": 158.0,
  "currency": "CZK",
  "id_membership": 1001,
  "membership": "Majitel",
  "member_card": false,
  "member_card_number": null,
  "membership_exp": "2049-06-18T00:00:00",
  "gdpr_souhlasy": 0,
  "minimum_kredit": 0.0,
  "phone": "777123456",
  "street": "...",
  "zip": "...",
  "city": "...",
  "country": "CZ",
  "language": "cs",
  "state": 0,
  "qr": "...",
  "loyalty_program_level": 1,
  "souhlasy_podminky": {...},
  "zmeny_provozu": {"sms":false,"email":false,"push":false},
  "obchodni_sdeleni": {"sms":false,"email":false,"push":false}
}

Klíčová pole:

• state: 0=registrace na recepci, 1=registrován, 2=email odeslán nepotvrzeno, 3=potvrzeno
• current_balance: zůstatek po odečtení budoucích rezervací
• pass: MD5 hash hesla (pro PUT)
• zam_kredit_1/2/3: zaměstnanecké kredity (členství 1000-1999)

Stav: ✅ Funguje (reálná user ID od ~4000000)

PUT api/User?user_id={user_id}

Aktualizace uživatelských údajů. Body = User_data objekt.

Response: {"success": 1, "messaget": "text"}

GET api/user/fu?user_id={user_id}

Fakturační údaje.

Response: Fakturacni_udaje

{"company_id":"","vat_id":"","name":"","surname":"","company_name":"","street":"","zip":"","city":"","country":"","typ_osoby":""}

Stav: ✅ Funguje

PUT api/user/fu?user_id={user_id}

Zápis fakturačních údajů. Body = Fakturacni_udaje.

Response: {"success": 1, "messaget": "text"}

GET api/user/membership?user_id={user_id}&lang={lang}

Členství klienta.

Response:

{
  "id_membership": 1001,
  "membership": "Majitel",
  "membership_od": "2022-02-01T00:00:00",
  "membership_do": "2049-06-18T00:00:00",
  "dluzne_clenstvi": 0.0,
  "mesicni_clenstvi": 0.0,
  "stav": 0,
  "stav_text": ""
}

stav (bitmask): 0=OK, 1=dluží další měsíc, 10=prošlé, 200=přerušené, 1000=dluh za členství, 2000=dluh za 1. platbu, 4000=dluh za zápisné

Stav: ✅ Funguje

GET api/user/credit_history?user_id={user_id}&lang={lang}&datum_od={datum_od}&datum_do={datum_do}

Historie pohybů na účtu.

Response: Array of Payment_history — { resort, datum, castka, cdd, text, uhrada, typ_uhrady, sportoviste }

• sportoviste: 1010=příjem kreditu, 1001=příjem členství, <1000=nákup služeb, >9000=nákup zboží

Stav: ⚠️ 404 (žádná historie v testu)

GET api/user/balicky?user_id={user_id}&lang={lang}

Balíčky klienta.

Response: Array of Balicek — { nazev, zdarma, zbyva, jednotka, od_kdy, do_kdy, id_balicku, id_typ_clenstvi, sleva_prc, kategorie }

• zdarma: počet jednotek zdarma (0 = prostá sleva)
• sleva_prc: sleva v procentech

Stav: ⚠️ 404

GET api/user/payment_order?user_id={user_id}&lang={lang}

Předpisy plateb za členství.

Response: Array of Payment_order — { rokmm, datum, predpis, uhrada, zbyva, text, membership }

Stav: ⚠️ 404

GET api/user/receipt?cdd={cdd}&resort={resort}&send_email={send_email}

Účtenka dle čísla dokladu.

Response: {"uctenka": "string"}

Registrace

POST api/Register

Registrace nového klienta.

Body:

{
  "login": "email@example.com",
  "password": "md5hash",
  "name": "Jan",
  "surname": "Novák",
  "email": "secondary@email.cz",
  "phone": "+420123456789",
  "member_card": "Ano",
  "agree_to_conditions": true,
  "company_name": "",
  "company_id": "",
  "language": "cs",
  "state": 2
}

• state: 2 = odeslat potvrzovací email, 3 = rovnou potvrzeno (bez emailu)

Response: Register_result_data

{"user_id": 4021141, "success": 1, "messaget": "OK"}

• success: 1=OK, -1=shoda email (potvrzený klient), -2=shoda email (nepotvrzený)

Stav: ✅ Funguje (reálně vytváří uživatele!)

POST api/Registerfinish

Dokončení registrace. Body: string (potvrzovací kód).

Response: {"ok": 1, "result_text": "text"}

Reset hesla

GET api/Resetpass?email={email}&phone={phone}

Odeslání kódu pro reset hesla (emailem i SMS).

Minimálně jeden parametr (email nebo phone) je povinný.

Response: {"ok": 1, "result_text": "text"}

• ok: -2 = email nenalezen

Stav: ⚠️ Funguje ale odesílá skutečné emaily/SMS

POST api/Resetpassfinish

Dokončení resetu hesla.

Body:

{"login": "email", "password": "md5hash", "uuid": "kód-z-emailu"}

Validate

GET/POST api/Validate?login={login}&password={password}

Ověření přihlašovacích údajů (počet záznamů v DB).

Response:

{
  "pz_username": 1,
  "pz_username_pass": 0,
  "pz_username_with_card": 0,
  "pz_username_without_card": 1
}

Stav: ✅ Funguje

Rezervace

GET api/Reservations?user_id={user_id}&historie={historie}&id_rezervace={id_rezervace}&lang={lang}

Seznam rezervací klienta.

Response: Array of Reservations_sel_result_data

Stav: ⚠️ 404 (žádné rezervace v testu)

POST api/Reservations

Vytvoření nové rezervace.

Body:

{
  "resort": 1,
  "id_kategorie": 2,
  "user_id": 3,
  "datum": "2026-03-20T14:00:00Z",
  "id_service_1": 5,
  "delka_1": 60,
  "id_resource_1": 7,
  "pohlavi_1": "M",
  "id_service_2": 0,
  "delka_2": 0,
  "id_resource_2": 0,
  "pohlavi_2": "",
  "poznamka": "text",
  "zpusob_uhrady": 0,
  "name": "Jméno",
  "surname": "Příjmení",
  "email": "email@test.cz",
  "phone": "+420...",
  "language": "cs"
}

• zpusob_uhrady: 0=standard (platba přes api/Payment), 100=splátky
• name/surname/email/phone: volitelné pokud je user_id zadán

Response:

{"success": 1, "messaget": "OK", "uuid": "abc-def-123"}

• success: 1=OK, 2=OK+platba nutná, -1=plno, -100=klient nenalezen, -200=nepovolené členství, -201=neplatné členství

DELETE api/Reservations/{id}?kategorie={kategorie}&resort={resort}

Smazání rezervace.

Response: {"success": 1, "messaget": "text", "storno_poplatek": 0.0}

Watchdog

GET api/Watchdog?user_id={user_id}

Aktivní hlídané termíny.

GET api/watchdog_II/user?user_id={user_id}

Rozšířené hlídané termíny.

GET api/watchdog_II/watchdog_id?watchdog_id={watchdog_id}

Hlídané termíny dle ID.

POST api/Reservations/watchdog

POST api/Reservations/watchdog_II

POST api/Reservations/watchdog_III

Vytvoření nového hlídání (základní, rozšířené, rozšířené+jazyk).

Body:

{
  "resort": 1, "id_kategorie": 2, "user_id": 3,
  "datum": "2026-03-20T00:00:00Z",
  "id_service_1": 5, "delka_1": 60,
  "poznamka": "text",
  "id_resource_1": 8, "pohlavi_1": "M",
  "id_watchdog": 0,
  "name": "", "surname": "", "email": "", "phone": "",
  "language": "cs"
}

DELETE api/Watchdog/{id}?resort={resort}

Smazání hlídaného termínu.

Response: {"success": 1, "messaget": "text"}

Stav: ⚠️ GET vrací 404 (žádná data), POST/DELETE netestováno

Vouchery

GET api/Voucher?id_voucher={id_voucher}&lang={lang}

Info o voucheru.

Response: Voucher_result_data

GET api/voucher/klient_parovane?id_klient={id_klient}&lang={lang}

Vouchery napárované na klienta.

POST api/voucher/klient_parovane

Spárování voucheru s klientem.

Body: {"id_voucher": 1, "user_id": 2, "id_payment_shop": "shop-id"}

POST api/Voucher

Uplatnění voucheru (stejné body).

Response: {"success": 1, "messaget": "text", "id_mp": 3}

Stav: ⚠️ GET vrací 404, POST netestováno

Platby

POST api/Payment

Zapsání přijaté platby.

POST api/Payment/Cancel

Oznámení o neúspěšné platbě.

Body (oba):

{
  "uuid": ["uuid-z-rezervace"],
  "user_id": 1,
  "amount": 500.00,
  "id_payment_shop": "shop-id",
  "id_payment_pp_1": "payment-id-1",
  "id_payment_pp_2": "payment-id-2",
  "zpusob_uhrady": 1,
  "zpusob_odeslani": 0
}

• uuid: "KREDIT" pro platbu kreditem, "VOUCHER" pro nákup voucheru
• zpusob_odeslani: 0=elektronicky, 1=papírově

Response: {"success": 1, "messaget": "text", "id_mp": 123}

Feedback

GET api/Feedback?lang={lang}&id_feedback_form={id_feedback_form}

Definice dotazníků (id_feedback_form=0 = všechny).

Response: Array of Feedback_form

[{"id_form":1,"nazev":"text","poznamka":"text",
  "list_items":[{"id_item":1,"poradi":1,"typ":1,"povolen_vlastni_text":0,"nazev":"text","moznosti":["a","b"]}]}]

POST api/Feedback

Odeslání vyplněného dotazníku.

Body:

{
  "id_form": 1, "user_id": 2, "poznamka": "text",
  "id_1": 4, "id_2": 5, "id_3": 6,
  "list_items": [{"id_item": 1, "vlastni_text": "text", "hodnota": 3}]
}

Stav: ⚠️ GET vrací 404 (žádné formuláře)

Akce

GET api/Akce

Seznam platných akcí/promo.

Response: Array of Akce_data

Stav: ⚠️ 404 (žádné aktivní akce)

SMS

GET api/Send_SMS?phone={phone}&text={text}&id_sms={id_sms}

Odeslání SMS.

⚠️ POZOR: Odesílá reálnou SMS! Netestovat bez důvodu.

Stav endpointů

✅ Funguje (12 endpointů)

❌ Server error (3 endpointy)

⚠️ Prázdná data / 404 (13 endpointů)

Tyto endpointy vrací 404 s prázdným tělem — pravděpodobně žádná data v testovací DB:

Akce, Masseurs, Staff, Feedback, Reservations (GET), Watchdog, watchdog_II, Voucher (GET), voucher/klient_parovane, user/credit_history, user/balicky, user/payment_order

Netestováno (17 endpointů)

POST/PUT/DELETE endpointy: Register, Registerfinish, Resetpassfinish, Payment, Payment/Cancel, Reservations (POST/DELETE), Watchdog (POST/DELETE), Voucher (POST), voucher/klient_parovane (POST), Feedback (POST), User (PUT), user/fu (PUT), Send_SMS

Důležité poznámky

• Formáty data jsou nekonzistentní:
• Freetime, Lesson: DD.MM.YYYY
• Courts: YYYY-MM-DD
• Všechny ISO formáty selhávají na Freetime/Lesson

• User ID reálných uživatelů začínají od ~4000000

• Členské ceny — API automaticky vrací jiné ceny na základě user_id (člen vs. host)

• Registrace (POST api/Register) skutečně vytváří uživatele v produkční DB — pozor!

• Send_SMS odesílá reálné SMS — nepoužívat pro testy

• Pouze resort=1 má data

• Pouze kategorie 10001 má služby, kategorie 100 má kurt